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PREFACE 

This manual describes the features of the MU BASIC/RT-11 system and 
the enhancements made to the BASIC-11 language for this system. 
BASIC-11 is digital's name for a family of BASIC' systems on the 
PDP-11. The reader is assumed to be familiar with the BASIC-11 
Language Reference Manual (DEC-11-LIBBA-A-D) , which describes the 
features common to all versions of BASIC-11. 

All users of an MU BASIC/RT-11 system should read this manual. Chap- 
ter 1 provides an introduction to the system and summarizes the 
enhancements of BASIC-11. Chapter 2 describes file manipulation and 
the input and output features available. Special system functions and 
commands are described in Chapter 3. Error messages are listed in 
Chapter 4. Appenaix h xists tne stctiiuai.u no<^j.x v-mnea- j.<-axi ^^^x^<^^j.^ 
Code for Information Interchange) characters. Appendix B contains 
a complete summary of all statements, functions, and commands. 
Appendix C describes the virtual array capability. The documentation 
conventions used in this manual are described in Appendix B. 

This manual assumes that the MU BASIC/RT-11 system is operational. 
The information to start and maintain an MU BASIC/RT-11 system can be 
found in the MU BASIC/RT-11 System Installation Guide (DEC-11-LIBMA-A-D) , 
but users who interface only with a working MU BASIC/RT-11 system do 
not need access to this guide. 



'basic is a registered trademark of the Trustees of Dartmouth College. 
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CHAPTER 1 



INTRODUCTION 



MU BASIC/RT-11 is a multiuser BASIC-11 system, capable of accommodat- 
ing up to eight users simultaneously. Each user independently creates 
and executes BASIC-11 programs. All the features of the MU BASlC/RT-11 
system, including statements, commands, functions, and immediate mode, 
are available to all users. 

MU BASIC/RT-11 runs under the RT-11 monitor. Users can access any 
RT-11-supported device, including disk, DECtape, magtape, cassette, 
card reader, high-speed paper tape reader/punch, and line printer. 

Throughout this manual the term BASIC refers to both the BASIC-11 lan- 
guage and to the MU BASIC/RT-11 System. 

1.1 GETTING STARTED 



To get started on an MU BASIC/RT-11 system it is first necessary to 
determine whether the system includes the HELLO feature. The HELLO 
feature restricts access to the system to authorized users. 

See the system manager of your installation to determine whether the 
HELLO feature is present. If the HELLO feature is not present, go to 
section 1.1.2. 

1.1.1 Getting Started on Systems with the HELLO Feature 

To get started with BASIC, it is necessary to get a user ID and a pass- 
word from the system manager. Without a user ID and a password, it is 
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Introduction 

impossible to run any BASIC programs. The user ID is a 2-character 
alphanumeric code. For example: 

F7 

A password can be up to six characters long. For example: 

PASED 

The combination of valid user ID and password allows access to the 
system. 

When the BASIC system has been started by the system manager, it prints 
on all terminals: 

MU BASIC/RT-11 IS ON THE AIR I 
PLEASE SAY HELLO 

The log-on procedure is the method by which a user gains access to the 
BASIC system. To log on, type HELLO and press the RETURN key. If 
anything not beginning with the letter "H" is typed, BASIC prints: 

PLEASE SAY HELLO 
After HELLO has been typed, BASIC prints: 

USERID: 
Type your user ID and press the RETURN key. BASIC then prints: 

PASSWORD: 

Type the password assigned and press the RETURN key. The characters 
that are typed are not displayed on the terminal. This ensures the 
privacy of the user ID-password combination. 

If the user ID and password entered are not valid, BASIC prints: 

INVALID ENTRY -- TRY AGAIN 
USERID: 
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If this message appears, the user ID and password must be reentered. 
This message is often caused by typing errors. 

If the user ID and password are valid, BASIC prints an informational 
message. For example: 

WELCOME TO MU BASIC/RT-11 

Then BASIC prints: 

READY 

This indicates that the user may enter any BASIC command, immediate 
mode statement, or program line. To terminate the session, use the 
BYE command (see section 1.1.3) . 

NOTE 



The CTRL/0 key command terminates output 
to the terminal and can be used during 
the log-on procedure to avoid the print- 
ing of the informational message. 

1.1.2 Getting Started on Systems Without the HELLO Feature 

When the BASIC system has been started by the system manager, it prints 
on all terminals: 

READY 

This indicates that the user may enter any BASIC command, immediate 
mode statement, or program line. The user ID of all users is AS and 
all users are privileged (see section 1.2). The HELLO command is not 
recognized and produces a ?SYN (SYNTAX) error message. 

To terminate the session, use the BYE command (see section 1.1.3). 

1.1.3 Terminating the Session - the BYE Command 
To terminate a session at the terminal, type 

BYE 
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and press the RETURN key. The BYE command deletes the current user's 
program and deassigns all devices assigned to the current user. 

On systems with the HELLO feature, BYE prints a message and then ini- 
tiates the log-on procedure. The message is: 

USERID XX LOGGED OFF — GOODBYE 

PLEASE SAY HELLO 

where xx is the user ID of the current user. 

On systems without the HELLO feature, BYE causes BASIC to print the 
READY message, 

1.2 RESTRICTED OPERATIONS 

Certain operations are restricted, to prevent one user from interfer- 
ing with other users' programs and files. Some operations are not 
allowed for any user, while other operations allowed for a privileged 
user are not allowed for a nonprivileged user. The system manager 
determines which users are privileged and which are nonprivileged. 

The following lists the operations that are restricted to privileged 
and nonprivileged users. Nonprivileged users can temporarily execute 
any operation allowed to privileged users when running a privileged 
program. See Section 2.3 for more information on privileged programs. 



Operation 
File Access 



Maximum number 
of simultaneously 
open files 

Maximum size of 
output data file 



Nonprivileged User 

Restricted by file 
protection system 
(see section 2.3) 

Restricted by sys- 
tem manager 



Restricted by sys- 
tem manager 



Privileged User 
Unrestricted 



Restricted only by 
system's resources 



Restricted only by 
available free 
space on the de- 
vice 



1-4 



Introduction 



Operation 

Nonfile- structured 
open of a file- 
structured device 
(see section 2.5.1.2) 



Execution of sys- 
tem functions 
(see section 3.4) 



Nonprivileged User 
Not allowed 



Certain functions 
are not allowed 



Privileged User 

Only prohibited when 
a public device is 
opened for output 
in a nonfile-struc- 
tured manner 

Unrestricted 



1.3 ENHANCEMENTS TO BASIC-11 

There are several features in MU BASIC/RT-11 that are not described in 
the BASIC-11 Language Reference Manual. All new and changed features 
are summarized in Tables 1-1, 1-2, and 1-3. 

The precedence of arithmetic operators is slightly different than that 
described in the BASIC-11 Language Reference Manual . Specifically, 
in the absence of parentheses MU BASIC/RT-11 has this order of 
priority: 

b. Unary minus 

For example, 

X-3 \ PRINT -2"2i--X"2j2"~2 

•■■4 -9 . 25 

READY 

The priority described in the BASIC-11 Language Reference Manual pro- 
duces values of +4 and +9 for the first two operations. The third 
operation (2f-2) produces the same values under both sets of 
priorities. Operations involving both exponentiation and unary minus 
should, in general, be enclosed in parentheses to avoid confusion. 
The immediate mode statement should be rewritten as: 

X-3 \ PRINT ■• (2'-2>p--<X"2).2'-(-2) 
-4 -9 .25 

READY 
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Table 1-1 
Enhancements to BASIC-11 Commands 



Command 



CTRL/C 



CTRL/Q 
CTRL/S 

CTRL/U 

ASSIGN device: 

BYE 

DEASSIGN [device:] 

HELLO 

KEY 

LENGTH 

SET TTY type 

TAPE 



UNSAVE file 
descriptor 



Meaning 



Key command; stops execution of the BASIC-11 state- 
ment or command, prints the following: 

+C 

STOP AT LINE xxxxx 

READY 

If a command or immediate mode statement is inter- 
rupted, the AT LINE is not included. CTRL/C can 
be disabled by special system function calls (see 
section 3.4.6). The response to CTRL/C may not be 
immediate if input or output is in progress. 

Key command; continues output to terminal after 
CTRL/S. May be labeled XON on some terminals. 

Key command; suspends all output to terminal until 
CTRL/Q, CTRL/0 or CTRL/C is typed. May be labeled 
XOFF on some terminals. 

Deletes the entire line currently being entered. 
BASIC prints: 

Assigns specified device to user if it is avail- 
able. 

Terminates the user's session. 

Deassigns specified device or all devices if none 
is specified. 

Special command to gain access to the MU BASIC/ 
RT-11 system. Not available on all systems. 

Enables echoing after TAPE command or SYS(l) or 
SYS (3) system function call. 

Displays the amount of memory used by the current 
program, expressed as number of words. 

Sets system to allow different terminals; type may 
be VT05, ASR33, or LA30. 

Disables echoing and enters special mode to allow 
use of the low-speed paper tape reader. 

Deletes specified file. 
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Statement 



Table 1-2 
Enhancements to BASIC-11 Statements 



KILL String 

LET VF mt 

(exprl)=expr2 

NAME stringl TO 
string2 

OPEN 



T 



Meanxng 



Deletes specified file. 

Special form of LET statement for use with virtual 
array files. 

Renames specified file. 



Opens data files; has new keywords for device op- 
timization and special form for virtual arrays. 



Table 1-3 
Enhancements to BASIC-11 Functions 




Meaning 



System function calls; to control output to ter- j 
minal and perform system operations. 

Causes the terminal head to move to specified 
column. If the column number specified is less 
than the current position, a carriage return with- 
out a line feed is printed and printing starts at 
the s'^ecified position on the same line (instead 
of resumina printing at the current position as 
described in the BASIC-11 Language Reference Manual 



1.4 ASSEMBLY LANGUAGE ROUTINES 

Any assembly language routines that the system, manager has included 
with MU BASIC/RT-11 can be executed by the BASIC-11 CALL statement. 
The CALL statement, including the implied call format, is described 
in the BASIC-11 Language Reference Manual. The system manager can 
provide further information on assembly language routines included 
(if any) . 
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INPUT AND OUTPUT 



2.1 MU BASIC/RT-11 FILES 

The MU BASIC/RT-11 file capability allows data and BASIC programs to 
be stored for future use. Programs that access files can manipulate 
data much faster and in larger amounts than programs that perform 
terminal input and output only. Saving programs in files makes it 
possible to restore them at a later time. Another program can run a 
saved program, by means of the CHAIN or OVERLAY statement. 

Data is" stored either in sequential files or in random-access, virtual 
array files. Sequential files are treated in the same way as terminal 
input/output -- data is read by an INPUT statement and written by a 
PRINT statement. Sequential files are useful for storing data that is 
to be processed serially. Virtual array files are similar to arrays 
stored in memory. An element of data in a virtual array can be part 
of any BASIC expression just the same as an element of a normal array. 
An element of a virtual array file can be assigned a value by a special 
form of the LET statement. Virtual array files allow data to be ac- 
cessed in a random, non-serial manner and are the only BASIC files in 
which existing data can be updated without rewriting the entire file. 

Each user creates and accesses files independently. A user creating 
a file can allow others to access the file or can restrict access to 
it. A privileged user can create a public or group library file that 
can be conveniently accessed by many users. All users can access pub- 
lic files whereas group files are only available to a specific group 
of users. 
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BASIC files can be created and accessed on any device supported by the 
RT-11 Monitor and included by the system manager in the BASIC system. 
Among the devices that may be included in the system are disk, DECtape, 
cassette, industry-compatible magtape, card reader, line printer, and 
high-speed paper tape reader/punch. 



NOTE 

Files can only be created on cassettes, 
disks, DECtapes, and magtapes that have 
been previously zeroed by the RT-11 PIP 
program. See your system manager or the 
RT-11 System Reference Manual for informa- 
tion on PIP. 



2.2 FILE DESCRIPTOR 

BASIC files are created and accessed by file control commands and state- 
ments. A file is specified by means of a file descriptor in the gen- 
eral form: 



[device: ] 



# 
L(aJ 



[filename] [ . [extension] ] 



where: 



device: is a legal anbreviation representing a device and 
may be any abbreviation listed in Table 2-1. 

$ denotes a public file. 

# denotes a group file. 

@ denotes a private file (default) . 

filename is the 1- to 6-character name of the file. 

extension is the 1- to 3-character extension of the file. 
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CR: 

CT [digit] : 

■r\V f j^ A ^A 4-^ • 

jJA [ U.JLVJ J. U J • 

DT [digit] : 

KB: 

LP: 

MT [digit] : 

PP: 

PR: 

RF: 

RK [digit] : 

SY[digit] : 
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Table 2-1 

Device Name Abbreviations 



Represents 



Card reader. 

Cassette (unit number specified by digit) . 

System device (unit specified by digit) . 

DECtape (unit specified by digit) . 

User's terminal. 

Line printer. 

Magtape (unit specified by digit] • 

High-speed paper tape punch. 

High-speed paper tape reader. 

Fixed-head disk. 

RKll cartridge disk (unit specified by digit) 

System device (unit specified by digit) . 



In addition to the devices listed in Table 2-1 any permanent device 
names added to the RT-11 Monitor can be used from BASIC. See the 
system manager for the devices and device name abbreviations that are 
available. 

It is not necessary to specify the device. When the device is not 
specified the system device is assumed. The system device can only 
be disk or DECtape. 



NOTE 






■Fi 



cation represents the device unit number. 
If the optional digit is omitted from SY 
or DK, the system device (unit from which 
system was bootstrapped) is assumed. If 
the optional digit is omitted from any 
other device name, unit is assumed. 



2^2.1 File Classes 



There are three classes of files: 



Public library files 
Group library files 
Private files 
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Public library files are accessible to all users. Programs that will 
be accessed by many users may be placed in the public library. In- 
cluding a dollar sign ($) in a file descriptor specifies a file in the 
public library. Public library files are stored internally as files 
with only one-character extensions. 

Group library files are accessible to a group of all users having the 
same first character in their user ID. For example, users with the 
user id's H9, HF, HO, and HZ belong to the same group (H is the group 
character) . A group library file is specified by including a number 
sign {#) in the file descriptor. Group library files are stored in- 
ternally with a two-character extension. The second character of the 
extension is the group character. 

A private file is accessible only to the user who has created it, A 
private library file can be specified by including the at sign ((?) or 
by not including any of the special file class symbols ($, # and @) . 
A private file is stored internally as a file with a three-character 
extension. The second and third characters of the extension are the 
characters in the user ID of the user who created the file. 

2.2.2 Filename and Extension 



When the specified device supports named files (disk, DECtape, cassette, 
and magtape support named files) the filename and extension specify 
the individual file on the device. Only one permanent file with a 
particular filename and extension can exist on a given device. If a 
new file is created on a device with the same filename and extension 
as a file already existing on that device, the old file is deleted 
when the new file is made permanent (closed) . But files with the same 
filename and extension can exist on different devices; they are com- 
pletely independent. 

For the line printer, high-speed paper tape reader /punch , card reader, 
or terminal, which do not support named files, any specified filename 
and extension are ignored. 

If a filename is not specified in a SAVE, REPLACE, or UNSAVE command, 
the current program name is the assumed filename. If any of the file 
descriptors in a KILL or NAME TO statement are missing the filename, 
the current program name is also assumed. The OPEN statement does not 
have a default filename. If neither a filename nor an extension is 
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specified, then a nonf ile-structured OPEN is attempted {see section 
2.5.1.2). All other statements and commands (APPEND, NEW, OLD, RENAME, 
CHAIN, and OVERLAY) assume the default filename "NONAME" when none is 



An extension specification is necessary only when accessing a private 
file of another user, a group file of another group, or a file that has 
a nonstandard extension. 

The first character of the extension depends on the type of file. If 
the file is a BASIC program (OVERLAY and CHAIN statements and APPEND, 
OLD, REPLACE, RUN, SAVE, and UNSAVE commands) the first character of 
the standard extension is B. If it is a data file (OPEN, NAME TO, and 
KILL statements) the first character of the standard extension is D. 

The extension actually used by BASIC is dependent on: 

the type of operation involved 

the user ID of the current user 

the extension specified (if any) 

the class of the file (determined by $, #, or !?) 

The type of operation involved determines whether the first character 
of the extension is D (for data file operations) or B (for BASIC pro- 
gram operations) unless an extension is specified. 

The user ID of the current user becomes the second and third characters 
of the extension actually used unless an extension is specified or a $ 
or # is specified. 

If an extension is specified, then that is the actual extension used 
unless a $, #, or @ is specified. 

If a file class is specified by a $ , # , or @ , then it determines the 
second and third characters of the actual extension used. If $ is 
specified (public library file) , then the second and third characters 
are nulls. If # is specified (group library file), then the third 
character is a null. And if (? is specified (private file) , then the 
second and third characters of the extension actually used are the 
user ID of the current user (see examples below) . 
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The following list contains file statements and commands and the de- 
vice, file name, and extension they will attempt to access. The access 
may be restricted by the file protection system (see section 2.3). 

These examples assume the current user ID is B9, and the current pro- 
gram name is EVENT. 



File Statement or 
Command 



File Specified 



Comment 



OPEN "DATA" AS FILE #1 



SY:DATA.DB9 



SAVE DTI: 



DT1:EVENT.BB9 



OLD $PROGRM 



SY:PROGRM.B 



OPEN "#MONEy.G" AS 
FILE #2 



SY: MONEY. GB 



The system device is as- 
sumed, the file name is 
specified, the first char- 
acter of the extension is 
D because OPEN is a data 
file statement and the 
last two characters are 
the current user ID. 

The device is specified, 
the program name is the 
file name, the first char- 
acter of the extension is 
B because SAVE is a BASIC 
program file command, and 
the last two characters 
are the current user ID. 

The system device is as- 
sumed, the file name is 
specified, the first char- 
acter of the extension is 
B because it is a program 
file statement, and there 
are no second and third 
characters because it is 
a public library file. 
The program name becomes 
PROGRM . 

The system device is as- 
sumed, the filename is 
specified, the first char- 
acter of the extension is 
specified, and because # 
specifies a group file, 
the second character is 
the group character and 
there is no third char- 
acter. 



OLD PR: 



PR: 



The papertape reader does 
not need a filename or ex- 
tension. The program 
name becomes the default 

NONAME . 
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File Statement or 
Command 



File Specified 



Comment 



OPEN "DT1:ABC.HB9" AS FILE 1 
OPEN "DT1:@ABC.H" AS FILE 1 
OPEN "DT1:@ABC.HHH" AS FILE 1 



DT1:ABC.HB9 



OPEN "STORE. R" AS FILE #1 SY: STORE. R 



OPEN "STORE" AS FILE #1 SY: STORE, DB9 



These statements are equi- 
valent. The first state- 
ment specifies the file 
descriptor exactly. The 
second specifies the @, 
filename, and first char- 
acter of the extension; 
the @ causes the second 
and third characters of 
the extension to be the 
current user ID. The 
third is the same as the 
second except that a three 
character extension is 
specified, but the second 
and third characters speci- 
fied are ignored because 
of the presence of @. 

The system device is as- 
sumed and the filename and 



CA UCllo-HJll 



. ISC 



exactly. This is a pub- 
lic library file because 
the second and third char- 
acters of the extension 
are nulls. 

The system device is as- 
sumed and the filename is 
specj-j. j-tiu . me ^--lj-sl. ijiicij. - 
acter of the extension is 
D because OPEN is a data 
file statement, and the 
last two characters of the 
extension are the current 
user ID because a private 
file is assumed. 



OPEN "STORE, 



AH FiLK ffl iiY:tiTUKE, 



The system device is as- 
sumed and the filename 
(STORE) and extension (the 
null extension) are speci- 
fied. 



OLD DT0:77GAME.B7R 



DT0:77GAME.B7R 



Another user's private 
file can be accessed only 
by specifying the exten- 



O J-V^ll. • 
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NOTE 



When the user ID is AS the default exten- 
sion for data files is ".DAT" not ".DAS". 
AT are the last two characters of the ex- 
tension in a data file statement only 
when neither the extension nor the file 
class is specified. The last two charac- 
ters of the extension in a BASIC program 
operation or when is specified are the 
normal AS. This feature allows compati- 
bility with the default extensions in 
the single user BASIC/RT-11. 

2.3 FILE PROTECTION SYSTEM 

There are several degrees of file access allowed: 

/ Run allows access by the RUN command or CHAIN state- 
ment. 

2. Read allows access by the OLD or APPEND command or the 
OPEN FOR INPUT or OVERLAY statement or use of the 
value of an element of a virtual array. 

3 Update allows access by the LET VF statement — can only 
be done to virtual array files. 



y 



Complete allows access by all of the above and by the SAVE, 
REPLACE, or UNSAVE command or the OPEN FOR OUTPUT, 
NAME TO, or KILL statement. 



A nonprivileged user is allowed compl ete access only to the user 's own 

private f iles. A nonprivileged user can have Run and Read access to 

■I - 

files in the public library and the user's own group library. No ac- 
cess is allowed (for a nonprivileged user) to other users' private 
files and files in other groups' libraries. The access allowed a non- 
privileged user to all files other than the user's own private files 
can be modified by the inclusion of a protection code in the filename. 

A privileged user has complete access to all files. Group library and 
public library files can only be created by a privileged user. 

When one of the four digits, 6, 7, 8, and 9, occurs in the first or 



second character position of a filename it has a special file access 
meaning. The ifirst character determines the access allowed all users 
in the group, specified by the second character of the extension of 
the file. The ^second character of the filename determines the access 
allowed for all other users ^ In public library files, the first char- 
acter position determines the access allowed for all users. The 
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following list describes the meaning of the digit 6, 7, 8, or 9 in the 
first or second character position. 

Digit Meaning 

6 Run, read, and update access. Allows all access except 
creating. 6 is only useful for virtual array files. 

7 Run and read access. 

8 Run access only. Program erases the user's storage 
area when it terminates execution (except when run by a 
privileged user) . 

9 Run access only. Program erases the user's storage area 
when it terminates execution (except when run by a 
privileged user) . Same as 8 except that the program 
can perform any privileged file operation or system 
function even when run by a nonprivileged user. 

Any other character in the first or second character position of a 
filename of a private file specifies no access allowed for users other 
than the file's creator. 

Any other character in the first character position of a filename for 
a group file specifies read and run access (equivalent to specifying 7) 
to users in the group. Any other character in the second position 
specifies no access for all users not in the group. 

Any other character in the first character position of a filename of 
a public library file specifies read and run access (equivalent to 
specifying 7) . 

A 9 in the first or second character position of a filename allows a 
nonprivileged user executing the program to perform any operation that 
a privileged user can. Only a privileged user can create a file with a 
9 in the first or second position. It is important that any such pro- 
grams be carefully coded to ensure privacy of confidential information. 
Because the program deletes itself on any program termination, includ- 
ing the CTRL/C key command and error conditions, there is no danger 
that a nonprivileged user can alter it. 
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NOTE 

A privileged user can run, read, update, 
or create any file. Only a privileged 
user can create group and public library 
files (with the exception that a non- 
privileged user with a one-character 
user ID can create group library files) . 



Examples: 



File can be read, run,, 
and updated by users 
in Group A. 



File can only be read 
or run by other users, 

Program can only be 
run; while it is exe- 
cuting any privileged 
operation can be per- 
formed. 

All users in group 5 
can read or run file. 

Other users can not read - 
file; they can only run 
it. Program will erase 
itself when it terminates 
execution. 



Filename 



6 7 ABC. DAI 



9DIR.B 



78ACNT.B5 



-Private file created by 
user with user ID Al. 



■Data file. 



-BASIC program in public 
library. 



.Group library file for 
group 5 . 

■BASIC program. 




gASIC PROGRAMS )IN FILES — UNSAVE COMMAND 



BASIC p rogram files are stored or updated with the SAVE or REPLACE 
command, respectively. These files can then be restored by the APPEND, 
OLD, or RUN command or the CHAIN or OVERLAY statement. These commands 
and statements are described in the BASIC-11 Language Reference Manual. 

Files containing BASIC programs can be del eted by the UNSAVE command . 
The form of the command is: 

UNSAVE file descriptor 

where 

file descriptor is described in section 2.2. 

A file can be deleted only by a user wh o has com plete access to it 
(see section 2.3). 
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Examples: 

These examples assume the current user ID is GR. 



UNSAVE TEST Deletes the file TEST.BGR from the system 

device. 

UNSAVE FILE2.DGR Deletes the data file FILE2.DGR from the 

system device. 



2.5 /Sata FILEs]^ 

2.5.1 Sequential Data Files 

Sequential files are treated in a manner similar to terminal input/ 
output; however, sequential file data can be manipulated in larger 
amounts and much more quickly than the equivalent terminal data. 
Data in sequential files must be accessed serially — to get to the 
last data item in a sequential file it is necessary to read the en- 
tire file. 

mU^ /-MI-CM r-.4- r^-t- ^vn^v^4- ^t7<:?/^^-i=4-QC? =a r^V»T7c?-ir^aT "Fllci aTion 1 f i e^ri VwT "t" h^ "F 1 1 *^ 
XiiO \J r- iJjL\ O UCL k-Cltl^ii V_ t*.3 OW*^-i-^ i-C^ »-t js^i. j .J j-x,v* -■- ^j^^^i ^j-^ — ^^ — ■ ^2 — -'— — — 

descriptor, with an internal logical unit number (also called channel 
number). A sequential file can be opened for output o r input . not 
for both. I To update an existing sequential file, it is necessary to 
open it for input and open a new file for output. Then all of the 
data must be read from the input file and written, including the up- 

The |PRINT #expr . statement outputs data to a sequential file opened 
for output. The expression after the number sign (#) must have the 
same value as the logical unit number of the file specified in the 
OPEN statement. The data stored in the file is the same data that 
would be printed on the terminal by an equivalent PRINT statement -- 
this includes space, carriage return, and line feed data. 

The ^INPUT #expr, statement reads data from a sequential file opened 
for input. The value of the expression following # must be the same 
as the logical unit number specified in the OPEN statement. Data is 
^p-^^ -p-v-^Tv» 4-V1/-1 -F -J 1q T_r\ -^v^g sam^e wa'^^ that it is in^ut from the term.inal; 
The INPUT #expr statement reads an entire line of data (up to a car- 
riage return) . If only one variable is specified in the INPUT # 
statement one data item is read from the file data line — any excess 
data is ignored. If more than one variable is specified, BASIC reads 
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as many data items from the line as needed. If there is insufficient 
data, BASIC reads the next data line from the file to get more data. 
If there is more than one numeric data item on a data line, they must 
be separated by commas — spaces alone can not be used to separate 
data items. 

String data is always read to the end of the line so there can only be 
one string data item on a data line. 

NOTE 



When creating a sequential file that is 
to be read later by the INPUT #expr 
statement, it is necessary to insert the 
separators required. Commas and carriage 
returns are valid separators. If there 
is more than one numeric data item on a 
file data line, the INPUT #expr must speci- 
fy a number of variables equal to the num- 
ber of data items. For example, the data 
written by: 

OPEN "DATA" FOR OUTPUT AS PILE #1 

PRINT #1, 5, ",", 1^ 

CLOSE 

would be correctly read by: 

OPEN "DATA" FOR INPUT AS FILE #2 

INPUT #2, A, B 

CLOSE 

Commas must be printed as strings (as in 
the above example) but carriage returns 
are output by BASIC after every PRINT 
#expr statement (unless the list is ter- 
minated by a comma or semicolon) . 

Once a data file has been opened for input, the end-of-file condition 
can be tested by the , IF END #expr statement,! An input file can be re- 
stored to the beginning (the first data item in the file is read next) 
by the ^RESTORE #expr, statement . 

Output files are made permanent when they are closed. ^ Files are closed 
by the exec^u t ion of the CLOSE. CHAIN, or END ,statpmpni- or the execution 
of the physical end of program (the highest numbered program line) . 
Files are not closed when program execution is terminated by execution 
of a CTRL/C key command or STOP statement or the occurrence of a fatal 
program error. 
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.An output file which has been opened but not yet closed is purged by 
the execution of the SCR, BYE, RUN. OLD, or NEW nnmmand.j If an out- 
put file is purged, all data output to the file is lost and the cur- 
rent contents of the file buffer are discarueu. 



Sequential files opened for input can be closed or purged, 
stored in the file is unaffected. 



The data 



NOTE 

The contents of a file buffer are not ac- 
tually output to the device until the buf- 
fer is filled or the file is closed. For 
example, all output to the line printer 
is not completed until the file is closed. 



The PRINT #, INPUT #, IF END #, RESTORE #, CLOSE, and OPEN statements 
are described in the BASIC-11 Language Reference Manual. Some addi- 
tional features of the OPEN statement are described in this section. 

The format of the OPEN statement for sequential files is: 



Tfor input "1 

-^t.. „ii J FOR OUTPUT] 



AS FILE [*lexprl (DOUBLE BUF] ( ,FILESIZE expr2 j [ ,RECORDSIZE expr3][,M0DE expr41 



where: 



string 



FOR iNFU'i' 



FOR OUTPUT 



# 
exprl 



DOUBLE BUF 



,FILESIZE expr2 



is a file descriptor as described in section 
2.2. It can be any string expression. 

specifies that an existing file is opened for 
input. FOR INPUT is assumed if neither FOR 
INPUT nor FOR OUTPUT is specified. 

specifies that a new file is created. Any 
existing file v.'ith the same file descriptor 
will be deleted when the new file is closed. 

is optional. 

is the logical unit number, an integer in the 
range 1-127. Other statements access the file 
by specifying the logical unit number associ- 
ated with it. The logical unit number is also 
known as the channel number. 

specifies that a second I/O buffer is allo- 
cated to the file if there is room in memory. 

determines the area allocated for an output 
file on disk or DECtape. It is ignored on 
other devices and for input files. 
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,RECORDSIZE exprS determines the buffer size for nonfile- 

structured devices or specifies a system 
buffer and channel (the latter is only 
available to privileged users) . 

,MODE expr4 specifies special handling of magtape or 

cassette file. See section 2.5.1.1. Any 
specified MODE is ignored for other devices. 

The FILESIZE option specifies the maximum number of 256-word blocks 
that the file can occupy. If FILESIZE is not specified, then a 
default maximum file size is provided by the system manager. The 
?IFL (Illegal File Length) error message is printed if a nonprivileged 
user specifies a FILESIZE less than or equal to zero or greater than 
the maximum size allowed by the system manager. 

For a privileged user a FILESIZE gives the standard RT-11 file size 
allocation (which is either the larger of the second largest free area 
or half of the largest free area) , a FILESIZE -1 gives the absolute 
largest free area, and a FILESIZE of less than -1 causes the ?IFL 
error message. 

When a file is closed, the size of the file is reduced to the number 

of blocks that have actually been used. If output is attempted past 

the file size allocated, the ?FTS (File Too Short) error message is 
produced and all data is lost. 

When calculating the number of blocks to allocate to a sequential 
file, the following facts should be considered: there are 512 char- 
acters per block, spaces are valid characters, and each line output 
has two characters (carriage return and line feed) added to it. Once 
a file has been created it can not be extended. 

The RECORDSIZE option can be used to specify the buffer size for a 
nonf ile-structured device. The buffer size is specified in bytes 
(two bytes equal one word of memory) . Output speed can be increased 
by specifying a buffer size larger than the default. The standard 
default buffer sizes are given in Appendix D. The ?IRS (Illegal 
Record Size) error message is produced when a nonprivileged user 
specifies a buffer size less than 1. 

The RECORDSIZE option can be used by a privileged user to request a 
system buffer and channel. If a RECORDSIZE -1 is specified and no 
area is available for a buffer in either the system I/O ars 
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area common to all users) or the user area, the file uses a system 
buffer. If no system buffer is currently available, the program waits 
for one to become free. A RECORDSIZE -1 also causes a system channel 

\^ij Dc Clfi3t;:^Cl xi- iiw Liacj- CriaHij.cx xo a. vdxxo.^.'j-^ • j-o. aiv^ ojf ^ t-t::AiL >^i.i,a.xi.i.iv^j. ^is 

available, the program waits for one. The effect of a RECORDSIZE -1 
is that the OPEN statement never fails because, if the channel pool 
is empty or because no memory is available for a buffer, BASIC waits 

i_ or a taVSueiU v^iianncx aiiia/t^X kjKAJ-j-^1. j.ixouc:cita y-/±. j-tsov^ jlai'j ci a-ai^dj, Cj-j-wj- 

message. If a privileged user specifies a RECORDSIZE of or less 
than -1 the ?IRS error message is printed. 

NOTE 



If neither filename nor extension is speci- 
fied in the file descriptor a ?FPV (File 
Protection Violation) error message is pro- 
duced for nonprivileged users; but, for 
privileged users, the device is opened in 
a nonf ile-structured manner. This can hap- 
pen if a string variable specifying the file 
descriptor is null. See section 2.5.1.2. 



Example: 

This example program creates a data file, closes the file, reads it 
back, and prints the sum on the line printer. 

10 REM PROGRAM IiEMONSTRATING THE OPEN STATEMENT 
20 OPEN "DATA" FOR OUTPUT AS FILE #:l. 

^cr r.r-w n r. tr A T ir c m iti-'MT tr T I i:r 
^".u I'm;:. ri t_-rM:.. fi i i...ij \j\j i t kj t i .1.1-. i.- 

30 FOR :i:-1. TO 100 

40 PR TNT tli'ly " ? " ?:i:"2 

50 REM THIS PRINTS I AND I-SOUARED 

60 REM TO THE FILE 

70 REM NOTE THE STRING GONSTANT « , " 

80 NEXT I 

100 CLOSE 1 

110 OPEN "DATA" FOR INPUT AS FILE #2 

120 IF END t2 THEN 200 

130 INPUT #2?l!.I2 

140 S=S+I \ S2'=S2+I2 

150 GO TO 120 

200 CLOSE 2 

210 OPEN "LPt" FOR OUTPUT AS FILE #1 

220 PRINT *1j"THE SUM OF THE NUMBERS"? 

230 PRINT *1?" 1 THROUGH 100 IS'sS 

240 PRINT #ly"THE SUM OF THEIR SQUARES IS "5S2 

250 CLOSE 
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2.5.1.1 Sequential Files on Magtape and Cassette - BASIC operations 
involving cassette and magtape devices are handled somewhat differ- 
ently from those involving other devices, because of the sequential 
nature of cassette and magtape. It is possible to have only one file 
open at a time on any given cassette or magtape unit. If an attempt 
is made to open a file on a unit which already has a file open on it, 
the ?NER (Not Enough Room) error message is produced. 

The last file on a cassette or magtape is specially formatted. It 
marks the end of the existing data and is where new output normally 
begins. After a new file is created on the device a new specially 
formatted file is written after it. This file marks the new logical 
end-of-tape. This specially formatted file is called a double end- 
of-file on magtape and the sentinel file on cassette. 

When a file is opened, the device (CT or MT) is first rewound and then 
the tape is read until the file specified in the file descriptor is 
found or the logical end-of-tape is reached. If the file is opened 
for input, the operation is finished if the file is found, or the ?FNF 
(File Not Found) error message is produced if the file is not found. 
If the file is opened for output and the file specified is found, a 
special empty file descriptor is written there (the old file is de- 
leted) and then the tape is read until the logical end-of-tape is 
found. In any case, once the logical end-of-tape is reached a file 
header is written and the operation is completed. This search proce- 
dure is employed because there is no inclusive directory at the begin- 
ning of the tape and the only way to access a file is to search the 
tape from the beginning until the file is found. 

NOTE 

An existing file on a cassette or magtape 
is deleted when a new output file with the 
same filename and extension is opened on 
the device, not when the file is made per- 
manent . 

In conditions when files on disk or DECtape are normally purged (see 
section 2.5.1), files on cassette or magtape are closed. This is done 
because it is not possible to create new files on a cassette or mag- 
tape if the last output file was not closed. If the tape is physi- 
cally removed from the drive before the CLOSE operation, there is no 
logical end-of-tape and it is not possible to create new files on the 
tape. The MODE option or the RT-11 PIP program (see your system 
manager) can be used to put a new logical end-of-tape on the device. 
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When a file on cassette or magtape is deleted a special file header 
is written to signify that the file is empty. When files are only 
written after the logical end-of-tape (the normal method of operation) , 
the space freed by the file deletion is not reused. Two methods are 
available to reuse the empty space. One is to use RT-11 PIP to copy 
the entire tape and then zero the old tape. The other method is to 
copy all the files after the empty file to a new tape and then use 
the mode option to create a logical end-of-tape before the empty file. 

MU BASIC/RT-11 does not support multiple volume files on cassette or 
magtape. If the physical end-of-tape is reached v/hile BASIC is writ- 
ing a file, the ?DHE (Device Hardware Error) error message is produced 
and the operation is terminated without being completed. The portion 
of the file that has been written as well as all the other files on 
the device can be read but no new files can be created on the device. 
When reading the last block written on the tape BASIC prints a ?DHE 
or an ?00D (Out Of Data) error message, depending on whether the last 
block was incomplete. 

The MODE option in the OPEN statement allows files to be specified by 
position as well as by the filename and extension. The MODE option 
can be used when it is not necessary or desirable to rewind the tape 
before each operation or when the file to be accessed is known to be 
in a certain position. The MODE option also allows new output to 
begin before the logical end-of-tape (or when there is no logical 
end-of-tape) . 

In an OPEN FOR INPUT statement, the MODE option limits the number of 
files to be searched and, if the file specified by the file descriptor 
is not found during the search, causes the last file in the search to 
be opened for input. If a positive expression is specified after 
MODE, the tape is not rewound and the search is limited to the in- 
teger value of the expression. For example, if the present position 
is after the 5th file on the tape and a MODE 3 is specified, the file 
specified by the file descriptor is opened if it is the 6th, 7th, or 
8th file on the tape - otherwise the 8th file on the tape is opened. 
A negative value for the expression following MODE has the same 
effect except that a rewind operation is done on the tape and then 
the absolute value of the expression is used to limit the search. 
For example, a MODE -5 causes the file specified by the file descrip- 
tor to be opened if it is the 1st, 2nd, 3rd, 4th, or 5th file on the 
tape - otherwise it causes the 5th file to be opened. If the logical 
end-of-tape is reached before the specified number of files have been 
searched, the ?FNF (File Not Found) error message is produced. 
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NOTE 



The use of MODE in the OPEN FOR INPUT statement is 
not restricted by the BASIC file protection system. 
Any file can be accessed by position including files 
that have been deleted and files with extensions 
different from the current user ID. To assure privacy 
of data on cassettes or magtapes, access to the tape 
must be restricted and the cassette or magtape unit 
assigned by the ASSIGN command (see Section 3.1) 
before the tape is mounted. 

The MODE option in an OPEN FOR OUTPUT statement causes output to 
begin at the position specified by MODE. If MODE is followed by a 
positive expression, no rewind operation is done and output starts 
at the file position specified by the integer value of the expression. 
For example, if the present position on the tape is after the 3rd 
file, a M0DE2 causes the new file to be created as the 5th file. All 
existing files after the fourth file are lost. If a MODE is followed 
by a negative expression, a rewind operation is done and output 
starts the position specified by the absolute value of the expression. 
If the logical end-of-tape is reached before the specified file 
position has been reached, output begins at the logical end-of-tape. 

All empty as well as active files on cassette and magtape are counted. 
RT-11 PIP can be used to create a magtape or cassette directory that 
lists all active and empty files. Magtape sometimes have an empty 
file inserted by the system at the beginning of the magtape. See 
your system manager or the RT-11 System Reference Manual (DEC-ll-ORUGA- 
B-D) for more information on PIP and magtape and cassette handling. 

Care must be employed when using the MODE option in an OPEN FOR 
OUTPUT statement. One reason is that if the rewind operation is 
inhibited (by a positive value of the expression) any file with the 
same filename and extension before the current position is not 
deleted. In this case, two files exist on the same device with the 
same filename and extension. In a subsequent OPEN FOR INPUT state- 
ment only the first file is seen unless the MODE option is used and 
the search begins after the first file. A second danger involving 
use of the MODE option in an OPEN FOR OUTPUT statement is that all 
files after the output file are lost. No check of file protection 
is made on these files; consequently, to prevent the loss of informa- 
tion stored on cassette, the cassette must be WRITE-PROTECTED (by 
uncovering the hole on the cassette) or access to the cassette must 
be restricted. 
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NOTE 

All files on cassette are written in 
groups of four 64-word blocks. The 
file header and sentinel file are 

T.71--1 -H -Hon -in c!i-ior>-ial '^')—wr\rri hi nr? Tcfi. 



2.5.1.2 Nonfile-Structured OPEN Statement - A privileged user can 
open a disk, DECtape, cassette, or magtape in a nonf ile-structured 
manner by not specifying the filename and extension. A disk or DEC- 
tape can be opened as either a sequential file or a virtual file (see 
section 2.5.2). In both cases the entire device is treated as though 
it were a normal BASIC file. To preserve the integrity of the system, 
public devices (see section 3.1) cannot be opened for output in a 
nonf ile-structured manner, even by a privileged user. Nonpublic de- 
vices can be opened for output but this should not be done to a device 
that contains any RT-11 files to be preserved because any existing 
files will be lost. 

Care must be employed when opening a cassette in a nonf ile- 
structured manner. Only a cassette that has been written in a 
nonf ile-structured manner can be read in a nonf ile-structured manner. 
Normal RT-11 cassettes can not be read in a nonf ile-structured man- 
ner and cassettes created in a nonf ile-structured manner cannot be 
read in a normal file-structured manner. 

In general, devices opened for output in a nonf ile-structured manner 
will be nonstandard and will not be readable by all RT-11 system pro- 
grams and should only be used if the maximum data storage capability 
of a medium is necessary. 

2.5.2 Virtual Array Files 

Virtual array files are special random-access binary files. There 
are three data types for virtual array files: integer, floating 
point, and string. A file can only contain one data type. 

Virtual array files have several advantages over sequential files: 

They can be accessed in a random, nonsequential 
manner. The last element of a virtual array file 
can be accessed as quickly as a.ny other element 
whereas it is necessary to read an entire sequen- 
tial file before accessing the last element. 
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Data conversions are not required because numbers 
are stored in binary; consequently there is no 
loss of accuracy in writing a number out to a vir- 
tual file and then reading it back. The data con- 
version required by sequential files causes some 
loss of precision. 

Virtual array files are the only BASIC files that 
can be updated without copying the entire file. 

Virtual array files are treated like normal arrays stored in memory 
with the following differences: 

Virtual array files allow the processing of much 
larger arrays than could fit in available memory. 

They also allow data to be saved from one execu- 
tion of a program to another. 

Elements of a virtual array file are not initial- 
ized to zero when a program is run. 

Integer virtual files are restricted to integer 
values; no similar restriction applies to any ar- 
ray in memory. 

Strings in virtual files have a fixed maximum 
length which is determined when the file is opened; 
elements of string arrays in memory can be any 
length (up to 255 characters) . Elements of string 
virtual arrays that are shorter than the maximum 
length have null characters appended to them until 
they are the maximum size. When an element is re- 
trieved it is stripped of its trailing null char- 
acters . 

Elements of a virtual array file can be assigned 
values only by a special form of the LET state- 
ment while elements of normal arrays can be as- 
signed values by the LET, READ, INPUT, or CALL 
statements. 

Virtual arrays can only have a single subscript 
(dimension) ; arrays in memory can have one or two 
dimensions. 



The special form of the OPEN statement for virtual files is: 



„„„„ ^ ■ Tfor input 

OPEN string 



FOR OUTPUT 



AS FILE VF int[|l [ (exprl) ] [=expr2] [:,FILESIZE expr3) 



where: 



string is a file descriptor as described in sec- 

tion 2.2 and can be any string expression. 

FOR INPUT an existing virtual array file is opened. 

Both output and input are allowed. If neither 
FOR INPUT nor FOR OUTPUT is specified, FOR 
INPUT is assumed. 
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FOR OUTPUT 



int 



exprl 



=expr2 



FILESIZE expr3 



specifies the creation of a new virtual array 
file. Any previous file with the same file 
descriptor is deleted when the new file is 
closed = Both output and input are allowed. 

is the virtual array logical unit number, an 
integer in the range 1 to 127. Elements of 
the array are accessed by specifying this 
virtual array logical unit number. This 
logical unit number is completely independent 
from sequential file logical unit numbers. 

indicates an integer virtual array file. 

indicates a string virtual array file. 

When neither % nor $ is specified, the vir- 
tual array file is floating point. 

is the dimension of the file. It is the maxi- 
mum subscript that can be used in accessing 
the array. This is not true when FILESIZE is 
also specified. 

is the fixed maximum string length in the 
range 1 to 255. This should be specified only 
when $ is also specified. Default value is 32. 

has the same meaning as in the normal OPEN 
statement (see section 2.5.1). The maximum 
legal subscript is determined by the number 
of elements that can fit in the file. When 
FILESIZE is specified it supersedes the di- 
mension specified in expr2. 



NOTE 

When a virtual file is first created, 
FOR OUTPUT must be specified but to up- 
date the data in the file FOR OUTPUT 
must not be specified. One consequence 
of this is that the program to create a 
new virtual file must be changed to up- 
date the file. 



The actual size of the permanent virtual file is determined only by 
the OPEN FOR OUTPUT Statement that created it. When the file is 
closed the file size is not reduced. Nor can the file be extended 
once it has been opened. The only way to extend a virtual array is 
to open a new, larger virtual array file and then copy all the data 
from, the old file to the new one. 
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To save the data in a virtual file, the file must be made permanent 
(closed) . Virtual files are made permanent or purged (lost) under 
the same conditions as sequential files (see section 2.5.1). 

Once a virtual array file has been opened its elements can be used 
the same as any other variables in a BASIC program with one exception: 
an element of a virtual array can only have a value assigned by a 
special form of the LET statement: 

[LET] VF integer (exprl)=expr2 



where : 



integer 

exprl 
expr2 



must be an integer constant (not an expression) 
and specifies the virtual array logical unit 

number . 

specifies the element in the array, 
must be the same data type as the array. 



If an integer virtual file element is assigned a value greater than 
32767 or less than -32768, the ?IDT (Illegal Data Type) error message 
is produced. 

Table 2-2 describes the nijmber of elements of each data type that can 
be stored in one 256-word (512-byte) block. 

Table 2-2 
Storage Requirements of Virtual Arrays 



Data Type 


Bytes per 

Element 


Elements per 
Block 


Floating point 


4 


128 


Integer (%) 


2 


256 


String ($) 


string length 


512/string length 


String ($) - default 
length 


32 


16 



The number of string elements per block can be fractional. 



NOTE 

Virtual files can exist only on disk or 
DECtape. 
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Examples: 

The following examples assxime the current user ID is B9. 

OPEN "TEST" AS FILE VFl$ (2000) = 10 

Opens the existing file SY:TEST.DB9 as virtual array 
file 1 containing 2001 string elements; each one 10 
characters long. This file is now available for 

element 2001 or greater causes an error. 

OPEN "TEST2" FOR OUTPUT AS FILE VF2$ (500) 

Creates a new file SY:TEST2.DB9 as virtual array file 
2 with 501 string elements, each 32 characters long. 

OPEN "TESTS" FOR INPUT AS FILE VF3 

Opens the existing file SY:TEST3.DB9 as virtual array 
file 3. It consists of floating point numbers because 
neither $ nor % is specified. Both input and output 
operations are legal. 

, __3ST4" 

OPEN A$ FOR OUTPUT AS FILE VF4% (50) ,FILESIZE (10) 

Creates the file SY:TEST4.DB9 and opens it for input 
or output as virtual array file 4 with 10 blocks. The 
FILESIZE specified overrides the dimension (50) ; conse- 
quently, elements to 2559 can be accessed. 

These files can then be used in BASIC operations as follows; 

LET A = B + VF3(I)/2 

Uses the value of virtual array file element VF3(I) in 
computing an expression. 

PRINT ■■VARIABLE" ,N,VF4 (N) 

Uses the value of integer virtual array file element 
VF4(N) in a print list, 

LET VF3(2*N+1) = (A + B)/2 

Sets the value of virtual array file element VF3(2*N+1) 

to "Clie VdJ-Ut; OJ- cue eAi-U-caoxuu \r\-ru//i.. 
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LET VFl(lOl) = "ABCD" 



Sets the value of string virtual memory file element 
VFl(lOl) to "ABCD" followed by six null characters. 
When VFl (101) is evaluated the trailing nulls will 
be automatically deleted. 



Any virtual file opened should be closed by the CLOSE statement. 



CLOSE [VF integerl [ ,VFinteger2 ,VFinteger3 , . . . ] ] 



Examples: 



CLOSE VF3 
CLOSE 



closes virtual file 3 

closes all files including virtual files 



Example: 



NOTE 

There may be problems when two users attempt 
to simultaneously assign values to elements 
of the same virtual array file. See section 
2.5.4. 



100 
110 

120 
130 

140 
1:?0 
2 00 
210 
22 
2:5 
240 
2 "5 
2 6 
270 
2^50 

2 9 

3 9 
3 1 
3 2 
330 
340 

36 
370 
380 
3 3 

1 
1 5 

1 9 1 



PRINT "OCTRL DUMP" \ REM THIS 

PRINT "FILE NAME"; \ REM DUMP 

INPUT F* 

PRINT "START BLOCK. tBLOCK'^ %■ 

INPUT Bl, B2 

OPEN Ft FOR INPUT ftS FILE VFl?; 



PROGRAM PRINTS AN OCTAL 
OF THE SPECIFIED FILE 



" FOR OUTPUT AS FILE #1 
"OCTAL DUMP OF FILE "; F* 
TO Bl+B£-i 



OPEN 'LP 

PRINT #1 

FOR B=B1 

PRINT #1 

PRINT #1 "BLOCK", B 

FOR L = TO OCT-i?-' 

LET ■■' = L*16 

GOSUB 1009 

PRINT #1 :SEr33:.;v*, 4 

FOR S=0 TO 7 

LET V = y F 1 < B ■+ 2 5 6 + L * 8 + 

GOSUB 1000 

PRINT #1 



fc. >j 



VSi 



HEKl S 
PRINT #1 
NEXT L 
PRINT #1 
NEXT B 
CLOSE »tl 
STOP 

LET V1=V 

REM 

LET V * = " 



i:EH 



R E M 



THIS SUBROUTINE 

INTEGER V 

TO ASCII STRING 



V$ 



ONVEFTS 
WHICi- 
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le-JQ LET Vi*=-0'' \ REM IS THE OCTAL VftLUE OF V 

1Q28 IF V> = THEN 1060 S REM USES Vi, V2, VK, Vlf .■ VS* 

1049 LET Vl=Vl+2'i5 \ REM V IS PRESERVED 

1050 LET Vl$=' 1' 
1060 FOR 1=1 TO 5 

1 a i' a L ii ! V" J- = t N I '•. '.' J. ••' <:■ •■' 

1080 LET V2* = STR*';Vl-'v'3*3> 

1090 LET V$ = V£*.&V$ 

1100 LET V1=V3 

1110 NEXT I 

1120 LET y$=vi*&y* 

1 ;l i rf K t I u !^. n 
For more information on virtual files see Appendix C. 
2.5.3 File Deletion and Renaming 

The NAME TO statement changes the name of a file on disk or DECtape;? 
it does not alter the contents of the file. The form of the NAME TO 
statement is : 

NAME stringl TO string2 



where : 

stringl is a file descriptor as described in section 2.2 
that specifies the file to be renamed. 

string2 is a file descriptor that specifies the new name 
and extension. No device should be specified. 

BASIC programs can be renamed by the NAME TO statement by explicitly 
specifying the extension. A NAME TO is illegal on cassette and mag- 
tape and is ignored on devices which do not support named files. 

Examples: 

These examples assume the current user ID is B9. 

NAME "DATA" TO "OLDDAT" Changes file SY:DATA.DB9 to 

SY:0LDDAT.DB9. 

NAME "apROG.B" TO "«PR0G2.B" Changes file SY:PR0G,BB9 to 

SY:PROG2.BB9. 

F$="PROG" Changes file SY:PR0G.BB3 to 

NAME "@"+F$+".B" TO "@"+F$+".A" SY:PR0G.AB9. 
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I The KILL statement deletes a file^ It is similar in effect to the 
UNSAVE command except that ^^KILL assumes a da ta file. The form of 
the KILL statement is: 

KILL string 

where : 

string is a file descriptor as described in section 2.2. 

Examples: 

These examples assume the current user ID is BS . 

KILL "FILEl" Deletes the file SY:FILEl.DBS. 
KILL "PROG. BBS" Deletes the file SY: PROG, BBS. 



2.5.4 Simultaneous File Updating Restrictions 

BASIC does not place any restriction on more than one user opening 
the same file. A user can be prohibited access to a file by the 
file protection system, but there is no mechanism to restrict access 
to a file only when another user has opened it. There is no conflict 
when only one user is writing to a file and all other users are 
reading it. There are two conditions in which conflict occurs: 

Two or more users have opened a file for output with the 
same filename and extension (on the same device) . 

Two or more users are updating an existing virtual array 
file. 

If two or more files are opened on a device with the same filename 
and extension, only the last file closed remains permanent. Ordinarily 
this problem should not occur since nonprivileged users do not have 
the ability to create files with extensions whose second and third 
characters are different from the user ID. It could occur if two or 
more users have logged into BASIC with the same user ID; consequently, 
this practice is not recommended. Privileged users do have the ability 
to create files with any extension and should take care that they do 
not create files with the same extension used by a nonprivileged user. 
The same restriction applies to replacing BASIC programs. 
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The virtual file facility provides a means for maintaining a data base, 
This data base can be read by more than one user simultaneously. It 
is important to note' that BASIC does not provide any record-locking 
facility. If two users attempt to write values into the same record, 
the user who accesses another record (or closes the file) last has 
the values written. The values written by all other users are lost. 
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SYSTEM COMMANDS AND FUNCTIONS 



3.1 ASSIGNING DEVICES 

BASIC ensures that each user can independently access devices. Some 
devices, disk and DECtape units, can be accessed safely by more than 
one user simultaneously. These devices are called public devices. 
Other devices, cassette, magtape, card reader, high-speed paper tape 
punch, high-speed paper tape reader, and line printer, can be accessed 
by only one user at a time. These are called nonpublic or assignable 
devices. In addition, the system manager can designate any disk or 
DECtape unit as nonpublic. 

NOTE 

Each separate unit of a device is con- 
sidered unique, for example, CT0: (Cas- 
sette unit 0) and CTl: (Cassette unit 1) 
are considered separate devices. 

Only one user can access a nonpublic device at any one time. The de- 
vice becomes available to other users only when the user currently 
accessing the device releases it. There are two ways to obtain access 
to a device: 

1) By means of the ASSIGN command, 

2) By means of a file-related comiriand or statement. 

When a user enters an ASSIGN command for an available device, BASIC as- 
signs the device to that user. No other user can access the device 
until the user who has obtained assignment enters a DEASSIGN or BYE 
command to deassign the device. When a user enters an ASSIGN command 
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for a public or unavailable device, the ?DNA (Device Not Available) 
error message is produced. 

If a user accesses an unassigned device by means of a file-related 
statement or command, the device is made unavailable to other users 
until the operation is completed. 

File-related statements and commands are the OPEN, KILL, NAME TO, 
OVERLAY, and CHAIN statements and the SAVE, UNSAVE, OLD, APPEND, and 
RUN file descriptor commands. (For all statements and commands except 
the OPEN statement the device is unavailable until the operation is 
finished.) After the execution of an OPEN statement the device is un- 
available to other users until all the user's open files on that de- 
vice are closed. 

Figure 3-1 illustrates the possible states for a nonpublic device. 



ASSIGN 




OPEN 



DBAS SIGN 



Figure 3-1 
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ASSIGNED signifies exclusive use and IN USE signifies temporary use. 
Both conditions can exist concurrently for the same user. OPEN sig- 
nifies execution of the OPEN statement or the beginning of any 

— .j_U— «. £4T« ■v'^l ^*- j^A r^*-%rrw«ra t^/5 r\v s"*" ^ -I- ^am ta r^ 4- PT-nCT? •ii-n^Tr«a-hoe -hVlO ovopil — 

tion of the CLOSE statement (or of any statement or command that 
closes files) or the completion of any file related command or state- 
ment (other than OPEN). A public device is always AVAILABLE, even 
when it is being used. 

Every file on a device must be closed before the device becomes avail- 
able. For example, if a user has not assigned a device but has opened 
two files on it, both files must be closed before the device becomes 
available to other users. 

The form of the command to assign a device is: 

ASSIGN device: 

where device: is one of the device symbols described in Table 2-1. If 
an attempt is made to ASSIGN a device that is already assigned to the 
same user the command is ignored and no error message is produced. 

The form of the command to deassign a device is: 

DEASSIGN [device:] 

where device: has the same meaning as in the ASSIGN command. 

If no device is specified in the DEASSIGN command, all devices as- 
signed to the user are deassigned. The BYE command also deassigns 
all devices. 

3.2 LENGTH CO^MAND 

The LENGTH command displays on the terminal the amount of storage re- 
quired by the BASIC program in memory. This information is useful in 
determining the minimum user area in which a specific program can run. 
The system manager can use this information in determining the size of 
the user areas (see MU BASIC/RT-11 System Installation Notes) . The 
form of the command is : 



LENGTH 
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The LENGTH command produces this message: 

mmm WORDS USED, nnn FREE 

where : 

mmm is the number of words currently occupied by the user's 
program 

nnn is the number of words remaining free in the user's area 

The number of words in use includes memory currently needed by the BASIC 
program itself, arrays, string variables, and file buffers in the user's 
area. To determine the size of the program alone, enter the LENGTH com- 
mand immediately after an OLD or CLEAR command. Arrays are created 
after the RUN command and file buffers are created when the OPEN state- 
ment is executed. The memory required for string variables and string 
arrays varies with the current values of the strings; consequently, the 
LENGTH command returns the current memory requirements, which may be 
smaller than the maximum memory requirements. 

Several error messages can be produced when the program exceeds the 
amount of memory available. These errors are ?ATL (Array Too Large) , 
?BSO (Buffer Storage Overflow) , ?PTB (Program Too Big) , and ?SSO (String 
Storage Overflow) . Program size can be reduced by several procedures: 

Eliminate or reduce unnecessary items such as REMark 
statements, long printed messages, and optional key- 
words such as LET, 

Make maximum use of multiple statement lines. 

Make efficient use of program loops, subroutines, 
user-defined functions, and computed GO TO state- 
ments. 

Split up large programs into several smaller pro- 
grams by use of CHAIN or OVERLAY statements. 

Reduce the size of arrays in memory to the size 
required (DIMension statement) . 

Use virtual array files for arrays that are too 
large to fit into memory. 

Reduce the number of variables and arrays in a pro- 
gram by reusing them when their contents are no 
longer needed, instead of creating new variables or 
arrays. 
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Reduce the number of simultaneously open files by 
opening a file just before it is needed and clos- 
ing it immediately after the last use. 

After program lines are deleted, the program can be stored by the SAVE 
command and restored by the OLD command to further optimize program 
memory requirements. 

File buffers are stored in a system I/O area common to all users if 
there is no room in the user area. If there is no room in either the 
user's area or the system I/O area, a ?BSO (Buffer Storage Overflow) 
error message is printed, except when a privileged user has specified 
the RECORDSIZE -1 option in the OPEN statement. See section 2.5.1 for 
a description of the RECORDSIZE option. 

For more information on program storage see Appendix D. 

3.3 TERMINAL CHARACTERISTICS 

Many different terminals can be used with BASIC. Several system func- 
tions and commands allow use of specific characteristics of the termi- 
nals. The SET TTY command specifies the class of terminal; system 
function 6 sets the width of the terminal; CTRL/S and CTRL/Q key com- 
mands stop and then restart output to the terminal, the TAPE and KEY 
commands, and system functions 1, 2, and 3 facilitate the use of the 
low-speed paper tape reader on the ASR33 terminal. The system func- 
tions are described in section 3.4. 

BASIC has a type-ahead feature which allows terminal input to be 
entered before BASIC is actually ready to process it. For example: 



fli-0b 



:.■ i --, IJ r- J ■:- L.j^i-, --7 c Mil LV' Uj C 
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While the paper tape is being read the LIST and RUN commands and the 
data 4 have been entered. The first READY indicates that the OLD com- 
mand has finished. The program is then listed and run. The question 
mark is produced by the INPUT statement; however, because the data has 
already been entered BASIC prints the values on the same line as the 
question mark. 

If the CTRL/C key command is typed at any time, however, it is seen 
first and any unprocessed type-ahead is discarded. 

If type-ahead exceeds thirty characters, the next character is accepted 
but is not echoed until the type-ahead is processed. If still more 
characters are entered BASIC rings the terminal bell to indicate that 
no more characters can be accepted. 

NOTE 



Extreme care should be used with the type- 
ahead feature. The printing on the termi- 
nal may become difficult to read. This 
does not affect the processing of the type- 
ahead. 

3.3.1 Stopping Output to Terminal 

The CTRL/S key command {may be labeled XOFF on some terminals) temporar- 
ily suspends all output to the terminal. This allows an alphanumeric 
display terminal (VT05, VT50, etc.) to be photographed, copied or read 
without the information on the screen being lost. The CTRL/S key com- 
mand itself does not cause any character to be printed on the screen 
(it is not echoed) . 

The CTRL/Q key command (may be labeled XON on some terminals) causes 
output to the terminal to resume. The CTRL/Q command itself does not 
cause any character to be printed (it is not echoed) . No characters 
are lost in a CTRL/S - CTRL/Q combination. In addition to its normal 
functions, the CTRL/C command also causes output to the terminal to 
resume after a CTRL/S command. 

NOTE 



While both the CTRL/O and CTRL/S key com- 
mands stop output to the terminal, they 
are not equivalent. The CTRL/O key com- 
mand causes all output to the terminal to 
be lost - the program continues executing 
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but does not print anything on the termi- 
nal . The CTRL/S command stops output to 
the terminal and program execution. When 
program execution is resumed (by the CTRL/ 
command) output resumes. No program 
output is lost during this CTRL/S and 
CTRL/Q combination. 

3.3.2 Using the Low-Speed Paper Tape Reader/Punch 

BASIC usually prints on the terminal's printer every character input 
by the low-speed paper tape reader or the keyboard. This process, 
called "echoing", provides a visual confirmation of what has been 
typed; however, when reading tapes from the low-speed reader echoing 
is often undesirable, because tapes often contain data that is fre- 
quently reused. 

The TAPE command stops the echoing process. It also causes the RUB- 
OUT key command to be ignored. This allows paper tapes to be input 
on the low-speed reader without printing the contents of the tape on 
the terminal. When creating a papertape to be input using the TAPE 
command, an erroneous character should be deleted by physically back- 
spacing the tape and then typing the RUBOUT key. 

The form of the command is: 



TAPE 



The TAPE command has the same effect as the system function 1. 

After the TAPE command has been executed the echoing process may be 
resumed by typing the KEY command. 

The form of the KEY command is: 



KEY 



If the TAPE command has been executed the KEY command itself is not 
echoed but all following characters typed at the terminal are echoed. 

The KEY command also causes RUBOUT to have its usual effect. 

Echoing is also resumed after a CTRL/C key command or the execution 
of system function 2 . 
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NOTE 



When creating binary tapes or tapes of 
BASIC programs (whose lines are longer 
than the terminal width) on the low-speed 
paper tape punch use the SYS (6,0) system 
function to prevent automatic printing of 
carriage return/line feed combinations. 
During its normal operation, BASIC occa- 
sionally outputs a null character to the 
low- speed punch. This is ignored when 
BASIC reads the tape. 

3.3.3 SET TTY Command 

The terminal type for all local terminals should be set by the system 
manager when the system is initialized; the SET TTY command should not 
be used on these terminals. However, to allow any type of dial-up 
terminal to be used, a user can set the correct number of fill charac- 
ters with the SET TTY command. In this respect, there are three 
classes of terminals: 

1. ASR33 Teletype' with low-speed paper tape reader /punch 
KSR33 Teletype 

ASR35 Teletype with low-speed paper tape reader/punch 

KSR35 Teletype 

LA3j2(-P Parallel DECwriter 

VTj2f5 Alphanumeric display with a data rate less than or 
equal to 3 00 baud. 

LA36 DECwriter II 

VT5J2f Alphanumeric display 

2. LA30-C Serial DECwriter 
LA30-E Serial DECwriter 

3. VT05 Alphanumeric display with a data rate greater than 

300 baud. 

For all terminals in the first class the appropriate SET TTY command 
is: 

SET TTY ASR33 

For serial LA30 DECwriters the appropriate command is: 

SET TTY LA3J3 



^Teletype is a registered trademark of the Teletype Corporation. 



3-8 



System Commands and Functions 



For a VT^5 alphanumeric display with a data rate greater than 300 baud, 
the appropriate command is: 



The SET TTY command has no effect on the terminal margin. See section 
3.4.5 for information on setting the terminal margin. 

3.4 SYSTEM FUNCTION CALLS 



System function calls perform a variety of operations. Certain system 
functions are available to all users. These cancel a CTRL/0 typed at 
the user's terminal, disable echoing, reenable echoing, enter a special 
single-character input mode, scratch the user's program in memory and 
then return to the READY message, and return the current user ID. Cer- 
tain other system function calls can be executed only by a privileged 
user. These disable the CTRL/C interrupt, set the user ID, terminate 
the privileged user status, and cause BASIC to exit and return control 
to the RT-11 monitor. 

The system functions can be used in any arithmetic expression, but for 
reasons of simplicity and compatibility it is recommended that system 
functions only be used in the LET statement. 

The format of the system function call in the LET statement is: 

[LET] var=SYS (exprl [ ,expr2] ) 

where 

var is the target variable. The value returned by 
the system function is stored in the target 
variable. 

exprl determines the system function to be performed. 

expr2 is an optional argument used in some SYS func- 
tion calls. 

Table 3-1 describes the system functions that are performed when exprl 
is in the range -4 to +8. If the value of exprl is less than -4 or 
greater than 8 the ?ARG (Argument Error) message is printed. If expr2 
is specified and not expected the ?SYN error message is printed. 
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Table 3-1 
Summary of System Function Calls 



Value of exprl 


Function Executed by the SYS Call 





Cancel effect of CTRL/0 typed on terminal. 


1 


Enter special mode for inputting tapes on the low- 
speed reader. 


2 


Enable echoing. Cancels effects of SYS(l) and 
SYS{3) . 


3 


Disables echoing. 


4 


Single character input mode. Target variable con- 
tains the ASCII value of the next character typed 
at terminal. Optional argument, expr2 , specifies 
logical unit number of file. 


5 


Delete current program, change program name to 
NONAME, and print the READY message. 


6 


Set the terminal margin to the value of expr2. 


7 


Re-enable CTRL/C as an interrupt. 


8 


Privileged function call; disable CTRL/C as an in- 
terrupt. Causes BASIC to ignore any CTRL/C typed 
at terminal. 


-1 


Privileged function call; sets the user ID to the 
value specified by ASCII value in expr2. If expr2 
is negative return the current user ID as the value 
of the function. 


-2 


Clear privileged user status. User will not be 
able to execute any privileged functions or file 
operation. 


-3 


Privileged function call; return to RT-11 monitor. 
A SYS (-3) function call should be executed by a 
privileged user only if he has notified all other 
users that the system will be taken down and that 
they should terminate their jobs. 


-4 


Return privileged status (+1 for privileged or 
for nonprivileged) . 



It is possible to combine two or more system function calls in one 
statement, for example, the statement: 

LET A = J2(*SYS(3) + SYS (4) + i2f*SYS(2) 

turns off echoing, inputs a character from the terminal, and turns 
echoing back on. The system functions are executed in order of the 
normal BASIC-11 precedence of operations. 
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3,4.1 System Function - Disabling CTRL/0 

The CTRL/0 key command stops output to the terminal; execution of the 
system function call causes output to resume. 

Example: 

In the following example, data is input from a file. Each value is 
printed on the terminal and then a sum is printed. A CTRL/0 key com- 
mand typed any time before line 100 is executed suppresses printing 
of all further data items but does not suppress the printing of the 
final sum. 



5 REM PROGRAM TO INPUT DfiTR 

? REM HN& PRINT SUM 

10 OPEN "PRI" POR INPUT flS FILE #1 

2S PRINT "DRTfl IN FILE: " 

iM IF END #1 THEN 166 

4& INPUT #1. D 

53 FRIN'" D, 

;fg T = T + D '■■-. GO TO 38 

i 1 8 P R INT '■■■. PRINT " S U M = " T 

3.4.2 System Functions 1, 2, and 3 - Using the Low-Speed Paper Tape 
Reader/Punch ~ 

BASIC usually echoes every character input by the low-speed reader or 
the keyboard. This provides visual confirmation of what has been 
typed; however, echoing is undesirab-Le in certain cases, ^ysv-em j.unc— 
tions 1 and 3 disable echoing. System function 2 enables echoing. 

System function 1 allows compatibility with paper tapes produced by 
other systems when they are read by the low-speed reader. System 
function 1 disables echoing and causes all RUBOUTs to be ignored. 
RUBOUT is the character normally used in BASIC to delete the previous 
character typed. Some other systems correct an error on paper tape by 
physically backing up the tape and then typing a RUBOUT to erase a 
character. System function 1 should only be used to read tapes pre- 
pared in this manner. System function 3 should be used for reading 
all other paper tapes on the low-speed reader. System function 2 
cancels the effect of system function 1 or 3 . Echoing is resumed 
and RUBOUT resumes its usual meaning. 
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Example 



le REM PROQRflM TO INPUT DhTh 

26 REM FROM THE LOW SF'EED READER 

2 5 D I M ft •'. 1 e ) 

j:0 Z = bVS'":3) \ REM OISfltLE ECHOING 

4m open "KB:" FOR INPUT fib FILE #6 

4 5 FOR 1=1 TO lOe 

60 INPUT #6,R(I> \ REM INPUT FROM RERDER 

?0 HEKT I 

10a Z = £VS'::2) '■■: REM RESUME ECHOING 



NOTE 

Turning off the echoing does not affect 
printing caused by PRINT statements and 
BASIC-11 messages, 

3.4.3 System Function 4 - Single-Character Input Mode 

System function 4 returns the decimal ASCII value of the next charac- 
ter input from the terminal or from a file. (See Appendix A for a 
list of the ASCII values.) System function 4 is the only method for 
BASIC programs to process terminal input without waiting for a car- 
riage return to be typed. This allows interactive programs to use 
single character response and not require a carriage return. 

Any key or key combination on the terminal is a valid response to a 
system function 4 input request except CTRL/S or CTRL/Q. CTRL/C 
is only valid if the CTRL/C command is disabled. 

Example 

10 PRINT "FOR K E L F T V P E H ~ - " ; 

29 P = 5 V S C 4 ) \ R E ;'i SINGLE C H R R h C: T E R I N F' ! I T 

2b PRINT 

;< IF K = fi S C ( " K " ) THEN 280 

4 S 1' F' 

209 PRINT "INFiiRfiHi ION THRT VuLi SHOULD KNOW" 

To input a single character from a sequential file, specify the logical 
unit number of the file as the second argument in the system function 
4 call. System function 4 then returns in the target variable the 
ASCII value of the next character in the file. All characters includ- 
ing nulls are returned. This allows data in any file to be read with 
no need for separating commas or carriage returns. Binary files can be 
copied exactly by use of system function 4. When the end of the file 
is reached system function 4 returns a value of -1. (Successive calls 
also return -1. ) 
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The file must be opened for input as a sequential file, not as a vir- 
tual file. 

NOTE 



If a file is opened on the terminal (KB:) 
a system function 4 acting on the terminal 
file is the same as a system function 4 
with no file specified. CTRL/S and CTRL/Q 
are not valid responses on a terminal to a 
system function 4 input request. 



Example 

This example will copy any RT-11 file exactly. 

10 PRINT "INPUT FILE"; 

20 INPUT I* 

30 PRINT "OUTPUT FILE"; 

40 INPUT 0* 

50 OPEN 1$ FOR INPUT flS FILE #i 

60 OPEN 0* FOR OUTPUT flS FILE #2 

7& fl=SVS<4. i> 

80 IF H=-l THEN 286 

90 PRINT #2, CHR^^fl); 

100 GO TO 70 

200 CLOEE 

210 GO TO 19 

This program is less efficient and slower than a copy program that uses 
string variables to copy files. But a copy program using string vari- 
ables does not copy some characters and requires that carriage returns 
separate strings. 

3.4.4 System Function 5 - Return to READY 

Execution of a SYS (5) system function call deletes the program in mem- 
ory, changes the program name to NONAME, and returns to READY. This is 
a useful method of terminating programs that are not to be rerun. 
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Example: 

LIST 

DELETE i7-MflF;-75 HU ERSIC/RT-ii V0i-06 

10 REH THIS PROGRRM WILL DELETE ITSELF 
20 fl=£VS<5> 

RERDV 

RUNNH 

READS' 

LIST 

NONRME 17-MRR-75 MU BRSIC/RT-ll V0i-ti6 

RERDV 

System function 5 is equivalent in effect to the SCR command. 

See the BASIC-11 Language Reference Manual for a description of the 
SCR command. 

3.4.5 System Function 6 - Terminal Margin 

System function 6 sets the maximum number of characters that can be 
printed on one line. BASIC initially assumes a terminal margin of 72 
and outputs a carriage return/line feed combination after printing 72 
characters on a line. Execution of system function 6 with a nonzero 
second expression (between 1 and 255) causes BASIC to output a car- 
riage return/line feed after printing the number of characters speci- 
fied in the second expression. The margin also affects echoing - if 
more characters are entered than fit on a line, a carriage return/ 
line feed is printed and the excess characters are echoed on the next 
line. 

If a line is partially full and there is not enough room for an 
output string (or number) , a carriage return/line feed combination 
is printed and the string (or number) is printed on the next line. 
An output string (or number) longer than a complete single line is 
continued on the next line. The process is repeated as many times as 
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necessary to print the entire string (or number) . Even if a line is 
partially filled when a system function 6 is executed, the margin is 
changed for that line. 

NOTE 

BASIC outputs characters to a terminal buffer and 
continues program execution without waiting for 
the characters to actually be printed on the ter- 
minal. If a system function 6 changes the margin 
while there are characters in the buffer, a 
carriage return will be printed when the new 
margin is reached or exceeded. But BASIC tests 
if a string or mamber will fit on a partially 
filled line before outputting the characters to 
the buffer and this test is not affected by a 
later margin change. 



Example: 



10 A:^^SYS<6i' JO) \ REM SETS MAR(3IN TO 10 

20 PRINT "1234567" ! "8901" 

30 PRINT "THIS LINE WON'T FIT!" 

RUNNH 

1234567 
8901 

THIS LINE 
WON'T FIT I 

READY 

With a margin of ten, the string "8901" does not fit on the first line 
of output, so it is printed on the second line. The string to be 
.•_ji._j T Ti ion -.T-; 1 1 r,^4- -Fn'-i- /-.n r\n o lino- =!n 1 +- IS nrinted ten 

characters per line until the string is exhausted. 

A system function 6 with a second expression equal to zero suppresses 
printing of any automatic carriage return/line feed combinations. 
This suppression is useful when preparing binary tapes or tapes of 

BASIC prugrcuiis ^wiiuat; j-j-^es are j.vjixyc;r tiidii ^^^^ ww^-..*— ^ / ^^i 

the low- speed paper tape punch or when using special cursor control 
characters available on some alphanumeric video display terminals. 
(Cursor control characters determine where on the video display 
screen the next printed character will appear.) 

To set BASIC to use the full width of an LA3G DECwriter II (132 
columns) type: 

A = SYS(6,132) 
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To set BASIC to use the full width of a VT50 alphanumeric display 
terminal or LA30 (8 columns) type: 

A = SYS(6,80) 

To set BASIC to use the full width of a VT05 or ASR33 {72 columns) 
type: 

A = SYS(6,72) 

This returns BASIC to the initial default state. 

3.4.6 System Functions 7 and 8 - CTRL/C Disable 

The system function call 8 is a privileged function call that causes 
the CTRL/C key command to be ignored. If a nonprivileged user at- 
tempts to execute SYS (8), the ?PSF (Privileged System Function) error 
message is produced. A program should be thoroughly debugged before 
the SYS (8) function call is inserted. 

The system function 7 can be executed by any user and it returns 
CTRL/C to its normal meaning. If CTRL/C is already enabled, a SYS (7) 
is ignored. 

NOTE 



If a program executes a SYS (8) function 
call and then enters a closed loop, it is 
not possible to halt the program. All 
other users are unaffected but it is not 
possible to use the terminal at which the 
error has occurred until the MU BASIC/ 
RT-11 system is taken down and then 
brought up again. 

3,4.7 System Function -1 - Set User ID 

The SYS(-1, expr2) function sets the user ID to the letters specified 
by a positive ASCII value in expr2 . This is a privileged system func- 
tion call. To set the user ID to a value "AB" the following system 
function call could be executed: 

A = SYS(-1, ASC("A")+256*ASC("B") ) 



3-16 



System Commands and Functions 



Only the ASCII values of the characters A through Z and the digits 
through 9 should be used for the user ID, The second character, how- 

file descriptors. 



If the value of expr2 is negative, the system function call can be 
executed by any user and it returns the current user ID. 

Example: 

18 fl=S'T'S'::-l.. -1> 

20 LI* = CHR* ■; R > +CHR* < R/25S > 

30 PRINT "CLfRRENT USER ID IS "..U* 

3.4.8 System Function -2 - Clear Privileged Status 

A SYS (-2) function call clears the privileged status indicator for the 
current user. After execution of a SYS (-2) function it is impossible 

to eXeuutfc: ci pi-xv j.j.cycv^ o_yaueiu x t-iii^- «-awa* wj. ** ^-.^.^^w^- — — ^ 

It is possible to regain the privileged status only by typing the BYE 
command and then logging on under a privileged user ID (see Chapter 1) . 

3.4.9 System Function -3 - Return to RT-11 Monitor 

SYS(-JJ is a priviiegea system ruriutxuii. xu axxuwo J3n..jxv- uw yj^ ^,s*4-^<=ii 
down to return control to the RT-11 monitor. SYS (-3) causes all users' 
programs to be terminated and erased and all files open for output to 
be deleted. After a SYS (-3) function call it is not possible to enter 
any commands or program lines to BASIC until BASIC is reloaded by the 
system manager. Consequently, all users should be notified, if pos- 
sible, before execution of a SYS (-3) function call. 
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3.4.10 System Function -4 - Return Privilege Status 

System function -4 returns the privilege status of the current user. 
This allows a privileged program (see section 2.3) to determine if the 
user running the program is privileged or nonprivileged. If the user 
is privileged a value of +1 is returned, but if the user is nonprivi- 
leged a value of is returned. For example: 



le H = £VS'::-4> 

20 IF fl=l THEN 18£i 

30 PRINT "ILLEGFiL OPERATION FOR NONPRIVILEGED USER" 

4S R = £VS';5) S REM RETURN TO REFiDV 

100 REM DO RESTRICTED OPERRTION HERE 
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ERROR MESSAGES 



When BASIC encounters an error, execution of the command or statement 
is interrupted and an error message is printed. Most errors are fatal 
and cause BASIC to print the READY message. The condition causing the 
error must be corrected before execution can be continued. 

Certain arithmetic and input errors are nonfatal. BASIC substitutes a 
default value for a nonfatal arithmetic error and resumes execution. 
When data in an illegal format is entered in response to an INPUT 
statement, the request for input is repeated. Nonfatal errors do not 
cause BASIC to print the READY message. 

BASIC detects errors when it executes commands, immediate mode state- 
ments, or program lines. Program lines that are typed are not checked 
for syntax errors until executed. No errors are produced when typing 
program lines or reading them from a file with these exceptions: ?LTL 
(Line Too Long) , ?TLT (Too Long to Translate) , ?PTB (Program Too Big) , 
and ?SYN (SYNtax error - caused when program lines in a file contain 
illegal characters) . 

When a program is interrupted by an error, BASIC includes in the mes- 
sage the line number of the statement causing the error. It is often 
useful to list this line and examine the values of the variables in 
the line by an immediate mode PRINT statement. 

The cause of the error can be corrected and execution of the program 
continued by the immediate mode GO TO statement. Execution of the 
program can also be started at the beginning by the RUN command. This 
will initialize all variables and delete any open files. To save the 
data in any open files, type an immediate mode CLOSE statement. 
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All error messages are printed in one of two formats 



message 



or 



message AT LINE xxxxx 



where xxxxx is the line number of the statement containing the error. 
Error messages produced by immediate mode statements or commands are 
printed in the first format. 

Table 4-1 lists all BASIC error messages. The message produced is in 
the abbreviated form unless BASIC has been assembled with longer error 
messages specified. All error messages are fatal unless the explana- 
tion specifies nonfatal. 



Table 4-1 
BASIC Error Messages 



Abbreviated 
Form 


Longer Form 


Explanation 


?ADR 
?ARG 

?ATL 

?BDR 
?BLG 


ADDRESS CHECK ERROR 
ARGUMENT ERROR 

ARRAYS TOO LARGE 

BAD DATA READ 
BAD LOG 


Internal system error. If 
error is reproducible, system 
manager should submit SPR. 

Arguments in a function do not 
match, in number, range, or 
type, the argioments defined for 

the function. 

Not enough memory is available 
for the arrays specified in the 
DIM statements. If the array can- 
not be made smaller, then reduce 
the size of the program (see 
section 3.2). Alternatively, 
a virtual array file may be 
used instead of an array in 
memory . 

Illegal characters in data item 
input from a file or from a 
DATA statement. 

Nonfatal, expression in LOG or 
LOGIO function is zero or nega- 
tive, BASIC returns a value of 
zero and continues execution. 
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Table 4-1 (Cont.) 
BASIC Error Messages 



Abbreviated 

Form 



?BRT 



?BSO 



?CAO 



?CHN 



?CNO 



?CPE 



?DEV 



Longer Form 



BAD DATA 
ERROR 



RETYPE FROM 



BUFFER STORAGE OVERFLOW 



CHANNEL ALREADY OPEN 



CHANNEL NUMBER FAULT 



CHANNEL NOT OPEN 



CHANNEL POOL EMPTY 



NO DEVICE HANDLER 



?DHE 



?DIR 



DEVICE HARDWARE ERROR 



DIRECTORY I/O ERROR 



Explanation 



Nonfatal, item entered in re- 
sponse to an INPUT or INPUT #0 
statement is in wrong format. 

X>ci+'\rr^c, T 4-£am rsT^rl r^v OCT 1^5*1^ WT T T 

continue. 

Not enough room available for 
file buffer in user area or 
system I/O area. Reduce pro- 
gram size (see section 3.2). 

OPEN statement specifies a 
channel (logical unit number) 
which is already associated 
with an open file. 

Internal system error. If 
error is reproducible, system 
manager should submit SPR. 

A PRINT #, PRINT USING #, INPUT 
# , IF END # , or CLOSE statement 
specifies a channel (logical 
unit number) not associated 
with an open file. 

All device channels are cur- 
rently in use . Caused by OPEN 
statement. Retry operation 
later. 

Handler is not currently avail- 
able to BASIC users. Notify 
the system manager. If the 
handler is present on the sys- 
tem device and has been loaded 
correctly (if in a F/B environ- 
ment) and error is reproducible, 
submit SPR, 

A device hardware error has 
been detected. This is often 
caused by an off-line or write- 
locked device. If error is re- 
producible and not caused by 
an off-line device or by output 
to a write-locked device, no- 
tify the system manager. 

An error has been detected dur- 
ing an RT-11 directory opera- 
tion. This is often caused by 
a write-locked device. If er- 
ror is reproducible and not 
caused by a write-locked device, 
notify the system manager. 
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Table 4-1 (Cont.) 
BASIC Error Messages 



Abbreviated 
Form 



?DRO 



?DNA 



?DNE 



?ENL 



?ETC 



7F-EMT 
7F-0VL 
?F-SYS 

PF-TRP 



Longer Form 



DIRECTORY OVERFLOW 



DEVICE NOT AVAILABLE 



DEVICE NOT ENABLED 



END NOT LAST 



EXPRESSION TOO COMPLEX 



none 

none 
none 
none 



Explanation 



There is no room in directory 
for a new file. Delete old 
files from device or use another 
device. 

The device requested is cur- 
rently in use by another user 
or another job (when the RT-11 
Background/Foreground monitor 
is used) . Use another device 
or try again later. This error 
message is also produced by an 
attempt to ASSIGN a public de- 
vice. 

Device is in LOCAL mode or not 
properly mounted. Enable de- 
vice and retry, or use another 
device. 

END statement is not the high- 
est numbered program line. 
Caused when END statement is 
executed and a program line has 
a line number higher than the 
END statement line number. 

The expression being evaluated 
caused stack overflow because 
it is too complex. This is usu- 
ally caused by user-defined 
functions or nested functions. 
The degree of complexity that 
produces this error varies ac- 
cording to the amount of space 
available in the stack at the 
time. Breaking the statement 
up into several simpler ones 
eliminates the error. 

Illegal EMT coded. 
Overlay read error. 
Fatal system error. 
Trap to location 4 or lj3. 

These are four fatal system er- 
rors. The message will be 
printed on the console terminal 
and will not include AT LINE 
xxxxx. Control will return to 
the RT-11 Monitor. The system 
manager must reload BASIC. If 
the error is reproducible and 
not due to a user programming 
error in an assembly language 
routine, submit SPR. 
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Table 4-1 (Cont.) 
BASIC Error Messages 



Abbreviated 
ForiTi 



?FAD 



?FTC 



FUNCTION ALREADY DEFINED 



ERROR IN FETCH 



?FNF 



?FOV 



FILE NOT FOUND 



FLOATING OVERFLOW 



?FPV 



?FRM 



FILE PROTECTION VIOLA- 
TION 

FORMAT ERROR 



?FSV 



?FTS 



NESTED FOR STATEMENTS 
WITH SAME CONTROL 
VARIABLE 



FILE TOO SHORT 



Ex'^lanation 



The user-defined function is 
previously defined. 

Device contains a bad block or 
is offline. Notify your sys- 
tem manager if the device is 
not offline. If error is not 
due to an offline device or a 
bad block and is reproducible, 
submit SPR. 

The file requested is not on 
the specified device. 

Nonfatal, the absolute value 
of the result of a computation 
is greater than the largest 
number that may be stored by 
BASIC (approximately lO'® ) . A 
value of zero is given to the 
expression and BASIC continues 
execution. 

Restricted file operation has 
been attempted . 

Format string error occurs in 
PRINT USING statement or an 
attempt was made to print item 
in the wrong type of data 
field. 



A FOR statement is inside a 
FOR-NEXT loop that specifies 
the same control variable that 
the FOR statement specifies. 

The specified or default FILE- 
SIZE in a data file opened for 
output is not large enough to 
hold the data. The file is not 
closed and all data is lost. 
Specify larger FILESIZE in OPEN 
statement. If this error mes- 
sage is produced by a SAVE or 
REPLACE command, save the pro- 
gram on cassette, magtape, or 
paper tape (if available) and 
notify system manager. 
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Table 4-1 (Cont.) 
BASIC Error Messages 



Abbreviated 
Form 



?FUN 



?FWN 



?FZD 



Longer Form 



FLOATING UNDERFLOW 



?ICN 



?IDM 



?IDT 



?IFL 



?IFS 



FOR WITHOUT NEXT 



FLOATING ZERO DIVIDE 



ILLEGAL CHANNEL NUMBER 



ILLEGAL DIM 



ILLEGAL DATA TYPE 



ILLEGAL FILE LENGTH 



ILLEGAL FILE 
SPECIFICATION 



Explanation 



Nonfatal; the absolute value 
of the result of a computation 
is smaller than the smallest 
number that BASIC can store 
(approximately 10~^^). A value 
of zero is given to the expres- 
sion and BASIC continues exe- 
cution. 

The program contains a FOR 
statement without a correspond- 
ing NEXT statement to terminate 
the loop . 

Nonfatal; computation includes 
a division of some quantity by 
zero. The expression is given 
a value of zero and BASIC con- 
tinues execution. 

The channel (logical unit num- 
ber) specified is not in the 
range 1-127 or the IF END state- 
ment specifies a file on a ter- 
minal. 

A subscript in a DIM or COMMON 
statement is not an integer 
number or an array is dimen- 
sioned more than once. 

The statement assigns a value 
greater than 32,767 or less 
than -32,768 to an element in 
an integer virtual array file. 

The FILESIZE specified in the 
OPEN statement exceeds the 
maximum size allowed. Error 
is also produced when FILESIZE 
specified is less than 1 for 
nonprivileged users (or less 
than -1 for privileged users) . 



The file specification does not 
conform to the required syntax, 
or contains illegal characters. 
Legal characters are the letters 
A through Z, the digits through 
9, and the special symbols ".", 
":", " " (blank) , "$", "#", and 
"@" which must be used as 
described in section 2.2. 
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Table 4-1 (Cont.) 
BASIC Error Messages 



Abbreviated 

Form 



?IID 



?IIM 



?INS 



Longer Form 



ILLEGAL I/O DIRECTION 



ILLEGAL IN IMMEDIATE 
MODE 



ILLEGAL NUMBER OF 
SUBSCRIPTS 



?IRS 



i ILLEGAL RECORD SIZE 



?LTL 



?MSP 






LINE TOO LONG 



MISSING SUBPROGRAM 



Explanation 



An attempt has been made to 
OPEN FOR OUTPUT a read-only de- 
vice (high-speed paper tape 
reader) or to OPEN FOR INPUT a 
write-only device (line printer, 
high-speed paper tape punch) . 
For example, the statement: 
OPEN "LP:" AS FILE 1 will gen- 
erate this error message be- 
cause FOR INPUT is assumed when 
neither is specified. 

The INPUT statement has been 
entered in immediate mode. 



More than two subscripts are 
specified in a DIM or COMMON 
statement or the array is di- 
mensioned with one subscript 
and referenced by two or vice 
versa . 

The OPEN statement specifies a 
RECORDSIZE less than one for 
unprivileged users or specifies 
a RECORDSIZE of zero or less 
than minus one for a privileged 
user. 

Q-l-TinrT •jrTT-t-nal ar-rsv OPFN sl-a-hp- 
" ^■*- - — z) ' u 

ment specifies a string length 
outside the range 1-255. 

An attempt has been made to 
enter a line longer than 132 • 
characters; the line is ignored. 
If this message occurs when 
BASIC is reading a program from 
a file, BASIC stops reading the 
file. 

Occurs when assembly language 
routines have been included with 
BASIC and a CALL statement 
specifies a nonexistent routine 
name. This error can also be 
caused by a syntax error in the 
first element of a line. BASIC 
interprets this error as an 
implied call statement. 
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Table 4-1 (Cont.) 
BASIC Error Messages 



Abbreviated 
Form 



Longer Form 



Explanation 



?NER 



NOT ENOUGH FILE SPACE 



?NFS 



?NGS 



?NOB 



?NRH 



?NSM 



?NVD 



?NWF 



NOT FILE STRUCTURED 



NEGATIVE SQUARE ROOT 



NUMBER OUT OF BOUNDS 



NO ROOM FOR HANDLER 



NUMBERS AND STRINGS 
MIXED 



NOT A VALID DEVICE 



NEXT WITHOUT FOR 



The device contains insuffi- 
cient free space to accommodate 
the requested file. Try again, 
and specify a smaller FILESIZE 
in the OPEN statement or a dif- 
ferent device. This error mes- 
sage is also produced when one 
user attempts to open more than 
one file simultaneously on one 
cassette or magtape unit. If 
this message occurs when access- 
ing a public device, notify the 
system manager. 

An attempt has been made to 
open a virtual file on a device 
other than DECtape or disk. 

Nonfatal, the expression in the 
SQR (square root) function has 
a negative value. The square 
root of the absolute value of 
the expression is returned and 
BASIC continues execution of 
the program. 

The absolute value of a numeric 
constant specified in a state- 
ment or in the VAL function is 
less than the smallest number 
BASIC can store (approximately 
10 ^M or is greater than the 
largest number BASIC can store 
(approximately 10^® ) . 

Currently the system I/O area 
has insufficient space for the 
non-resident handler of the re- 
quested device. If possible 
use another device or retry the 
operation again later. 

String and numeric values ap- 
pear in the same expression or 
they are set equal to each 
other; for example, A$=2. 

The device name is not valid or- 
is not available to BASIC users. 

A NEXT statement has been exe- 
cuted without a corresponding 
FOR statement. 
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Table 4-1 (Cont.) 
BASIC Error Messages 



Abbreviated 
Form 



?00D 



?PSF 



?PTB 



Longer Form 



OUT OF DATA 



PRIVILEGED SYSTEM 
FUNCTION 



PROGRAM TOO BIG 



i ?RPL 



USE REPLACE 



?Rwr; 



?SOB 



RFTTTRM WITHOUT f^nRtlB 



SUBSCRIPT OUT OF BOUNDS 



?SSO 



STRING STORAGE OVERFLOW 



jixpianation 



The data list has been exhausted 
and a READ statement requests 
additional data or the end of a 
file has been reached and the 
INPUT # statement requests ad- 
ditional data. 



A nonprivileged user has at- 
tempted to execute a privileged 
system function call. 

The line just entered causes 
the program to exceed the user 
code area; the line is ignored. 
Reduce program size (see sec- 
tion 3.2). If this error oc- 
curs when BASIC is reading a 
program from a file, BASIC 
stops reading the file. 

An attempt has been made to 
save a program in a file that 
already exists on the device. 
The operation does not occur 
and the original file is not 
disturbed. Use the REPLACE 
command if the operation is 
intended. 

A RETURN is encountered before 
execution of a GOSUB statement. 

The subscript computed is less 
than zero or is outside the ' 
hounds defined in the DIM 
statement or outside of the 
limits of the virtual array file. 

Not enough memory is available 
to store all the strings used 
in the program. Reduce program 
size (see section 3.2). 



?STL 



STRING TOO LONG 



The maximum length of a string 
in a BASIC statement is 255 
characters. 
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Table 4-1 (Cont.) 
BASIC Error Messages 



Abbreviated 

Form 



Longer Form 



Explanation 



?SYN 



SYNTAX ERROR 



?TLT 



TOO LONG TO TRANSLATE 



?TMC 



?TMG 



?UFN 



?ULN 



TOO MANY CHANNELS 



TOO MANY GOSUBS 



UNDEFINED FUNCTION 



UNDEFINED LINE NUMBER 



?USR 



?+ER 



ILLEGAL USR/EXIT CALL 



+ERROR 



BASIC has encountered an unrec- 
ognizable element. Common 
examples of syntax errors are 
misspelled commands, unmatched 
parentheses, and other typo- 
graphical errors. This mes- 
sage can also be produced by 
attempting to read in a program 
from a file containing illegal 
characters in which case BASIC 
stops reading the file. 

Lines are translated as they 
are entered and the line just 
entered exceeds the area re- 
served for translating; the 
line is ignored. If this mes- 
sage is produced while BASIC is 
reading a program from a file, 
BASIC stops reading the file. 

OPEN statement exceeds the maxi- 
mum number of files that may 
be opened simultaneously by a 
nonprivileged user. 

More than twenty GOSUBs have 
been executed without a corre- 
sponding RETURN statement. 

A user-defined function has 
been used and not defined. 

The line number specified in 
an IF, GO TO, GOSUB, ON GO TO, 
ON GOSUB, CHAIN, or OVERLAY 
statement does not exist any- 
where in the program. 

Internal system error. If er- 
ror is reproducible, system 
manager should submit SPR. 

The program has tried to com- 
pute AfB, where A is less than 
13 and B is not an integer . 
This would produce a complex 
number which can not be repre- 
sented in BASIC. This message 
is also produced when A is less 
than zero and B is an integer 
with an absolute value greater 
than 255. 



Error Messages 



BASIC functions that are called improperly cause error messages to be 
printed. Table 4-2 describes under what conditions BASIC functions 
produce errors . 



Table 4-2 
Error Conditions in BASIC Functions 



Function 



All functions 



All functions 



ASC (string expr) 



I O TXT / <!?i^ V T irtrf *^-*^rsv \ 



CHR$(expr) 
EXP (expr) 
FNletter 

LOG (expr) 

LOG 10 (expr) 

OCT (string expr) 

PI 

SEG$ (string expr, 

— --jr^ — ' — ^L ' 

SQR(expr) 



Condition 



The argument used is the wrong 
type. For example, the argument 
is numeric and the function ex- 
pects a string expression. 

The wrong number of arguments 
has been used in a function, or 
the wrong character has been used 
to separate them. For example, 
PRINT SIN (X,Y) produces a syn- 
tax error because the SIN func- 
tion has only one argument. 

String expr is not a one character 

string. 



r'Via T-a^-j-cki* otner 



■7 01^0 



or one in string or value is 
greater than 2 ^ . 

Expr is not in the range 0-32767. 

Expression is greater than 87 . 

The function FNletter has not 

defined by an immediate mode state- 
ment) . 

Expression is negative or 0. BASIC 
returns a value of 0. 

Expression is negative or 0. BASIC 
returns a value of 0. 

Character other than blank or digits 
0-7 in string or value is greater 

than 2^^. 

An argument is included. 

No additional error conditions. 



Expression is negative; BASIC returns 
the square root of the absolute value 
of the expression. 



Error 
Message 



?ARG 



?SYN 



?ARG 
?ARG 

?ARG 
?+ER 

?UFN 

?BLG 
?BLG 
?ARG 

?ARG 



?NGS 
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Table 4-2 (Cont.) 
Error Conditions in BASIC Functions 



Function 


Condition 


Error 
Message 


SYS(exprl[,expr2] ) 

TAB 

VAL (string expr) 


A nonprivileged user has attempted to 
execute a privileged system function 
call. 

The value of the first expression is 
less than -4 or greater than 8 or a 
second expression is specified when 
none is expected. 

Expression is not in the range 0- 
32767. 

String expr is not a numeric constant. 


?PSF 
?ARG 

?ARG 
?ARG 
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ASCII CHARACTER SET 



The following table shows, with the corresponding octal and decimal 
codes, the 128-character ASCII (American Standard Code for Information 
Interchange) character set. These codes are used to store ASCII data 
in files and to store them internally. 

The BASIC user can convert an ASCII value to the corresponding string 

the corresponding ASCII value with the ASC function. These functions 
are described in the BASIC-11 Language Reference Manual . A special 
system function (see section 3.4.3) returns the ASCII value of charac- 
ters input from the terminal or a file. 



sons. See the BASIC-11 Language Reference Manual for a description of 
string relational operators. 

BASIC converts to upper case all lower case letters entered at the 
terminal. No conversion is done on terminal output or input and 
output with any other device. 

The octal code is provided for reference. BASIC does not support octal 
numbers except through the OCT function (see the BASIC-11 Language 
Reference Manual) . 

eighth (high order) bit is normally zero. 
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Table A-1 
ASCII Character Set 





ASCII 






ASCII 


7-Bit 






Decimal 


Octal 






Code 


Code 


Character 







000 


NUL (CTRL/@) 




1 


001 


SOH (CTRL/A) 




2 


002 


STX (CTRL/B) 




3 


003 


ETX (CTRL/C) 




4 


004 


EOT (CTRL/D) 




5 


005 


ENQ (CTRL/E) 




6 


006 


ACK (CTRL/F) 




7 


007 


BEL (CTRL/G) 




8 


010 


BS (CTRL/H) 




9 


Oil 


HT (CTRL/I or TAB) 




10 


012 


NL (NEW LINE or LINE 


FEED) 


11 


013 


VT (Vertical TAB) 




12 


014 


FF (Form Feed) 




13 


015 


RT (Return) 




14 


016 


SO (CTRL/N) 




15 


017 


SI (CTRL/O) 




16 


020 


DLE (CTRL/P) 




17 


021 


DCl (CTRL/Q) 




18 


022 


DC 2 (CTRL/R) 




19 


023 


DC3 (CTRL/S) 




20 


024 


DC 4 (CTRL/T) 




21 


025 


NAK (CTRL/U) 




22 


026 


SYN (CTRL/V) 




23 


027 


ETB (CTRL/W) 




24 


030 


CAN (CTRL/X) 




25 


031 


EM (CTRL/Y) 




26 


032 


SUB (CTRL/Z) 




27 


033 


ESC (ALTMODE) 




28 


034 


FS (CTRL/\) 




29 


035 


GS (CTRL/I ) 




30 


036 


RS (CTRL/") 




31 


037 


US (CTRL/_) 




32 


040 


SP (space bar) 




33 


041 


; 




34 


042 


11 




35 


043 


# 




36 


044 


$ 




37 


045 


% 




38 


046 


& 




39 


047 


1 




40 


050 


( 




41 


051 


) 




42 


052 


* 




43 


053 


+ 




44 


054 


/ 




45 


055 






46 


056 


^ 




47 


057 


/ 




48 


060 







49 


061 


1 




50 


062 


2 




51 


063 


3 




52 


064 


4 




53 


065 


5 
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Table A-1 (Cont.) 
ASCII Character Set 



ASCII 
Decimal 
Code 



54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 



ASCII 
7-Bit 
Octal 
Code 



066 
067 

mn 

VJ f \J 

071 
072 
073 
074 
075 
076 
077 
100 
101 
102 
103 
104 
105 
106 
107 
110 
111 
112 
113 
114 
115 
116 
117 
120 
121 
122 
123 
124 
125 
126 
127 
130 



Character 



> 

? 

@ 
A 
B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 
O 
P 

Q 
R 
S 
T 
U 
V 
W 
X 



89 
90 


131 
132 


Y 
Z 




91 


133 


J 




92 


134 


\ 




93 


135 


] 




94 


136 


+ or 


/N 


95 


137 


-^ or 




96 


140 






97 


141 


a 




98 


142 


b 


1 
1 


99 


143 


c 




100 


144 


d 




101 


145 


e 




102 


146 


f 




103 


147 


g 




104 


150 


h 




105 


151 


i 




106 


152 


j 




107 


153 


k 
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Table A-1 (Cont.) 
ASCII Character Set 





ASCII 




ASCII 


7-Bit 




Decimal 


Octal 




Code 


Code 


Character 


108 


154 


1 


109 


155 


m 


110 


156 


n 


111 


157 


o 


112 


160 


P 


113 


161 


q 


114 


162 


r 


115 


163 


s 


116 


164 


t 


117 


165 


u 


118 


166 


V 


119 


167 


w 


120 


170 


X 


121 


171 


y 


122 


172 


z 


123 


173 




124 


174 




125 


175 




126 


176 


~ 


127 


177 


RUBOUT 
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SUMMARY OF BASIC STATEMENTS, FUNCTIONS, AND COMMANDS 



This appendix summarizes the statements, functions, and commands in 
MU BASIC/RT-11. These sximmaries supersede the summaries provided in 
the BASIC-11 Language Reference Manual. 

B.l DOCUMENTATION CONVENTIONS 

Certain conventions are used to describe the format of the BASIC lan- 
guage throughout this document. Tables B-1 and B-2 describe these 
conventions. See the BASIC-11 Language Reference Manual for a more 
complete description of the terms used. 



Table B-1 
Documentation Conventions 



Convention 


Meaning 


Items in lower- 
case letters 

Items in capital 
letters and 
special symbols 

Braces 


Elements to be supplied by user according 

to rules explained in the text. Table B-2 
provides a description of some frequently 
used elements and abbreviations. 

BASIC keywords, must appear exactly as shown 
because they form the vocabulary of the 
BASIC-11 language. For example, LET, IF, 

OPEN , RUN , # , and / . 

A choice of one element among two or more 
possibilities, for example: 

^THEN statement | 
<|then line number > 
(go TO line number) 
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Table B-1 (Cont.) 
Documentation Conventions 



Convention 


Meaning 


Square brackets [] 
Ellipsis . . . 


Optional element or a choice among optional 
elements, for example: 

[LET] variable = expression 

OPEN string^^O^ ™PUtJ ^^ ^^^^ ^^^^^ 

Preceding elements may, at the user's option, 
be repeated, for example: 

CLOSE #exprl, #expr2, #expr3, . . . 

DEF FNletter (varl[ ,var2 , . . . ,var5] )=expr 



Lower-case words that appear in a description of the format of a BASIC 
statement, function, or command represent elements that must be sup- 
plied by the user according to the rules provided. When one of these 
words is repeated a number or letter appendage serves to identify each 
separate element in the explanations. Table B-2 describes the meaning 
and abbreviations used for some elements. 



Table B-2 
Lower-Case Words Used in Format Descriptions 



Word 


Abbreviation 


Meaning 


expression 


expr 


Any valid BASIC expression. 


string expression 


string expr 


Any valid BASIC string expression. 


integer 


int 


Any positive integer (must be a 
numeric constant) . 


line number 




Any legal line number. Must be a 
one to five digit number within 
the range 1 to 32,767. 


relational operator 


rel-op 


An arithmetic or string relational 
operator. 


variable 


var 


A name representing a numeric 
or string variable. 
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B,2 SUMMARY OF BASIC STATEMENTS 



The following summary of BASIC statements defines the general format of 
each statement and gives a brief e 
ets [] indicate optional elements. 



each statement and gives a brief explancttion uf ita uae. Suaaj-e bj.ack 



[CALL "] routine name["] (argument list) 

Used to call assembly language routines from a BASIC program. The 
word CALL and the pair of quotation marks should either both be 
excluded or both be included. 

CHAIN string [LINE line number] 

Terminates execution of the program, loads the program specified 
by string, and begins execution at the lowest line number or, 
when a line number is present in the CHAIN statement, at the 
specified line number. The string may be any string expression 
and is a file descriptor as described in section 2.2. 

CLOSE [[#]exprl, [#] expr2 , [#] expr3, . . . ,VFintl,VFint2, . . . ] 

Closes the file(s) associated with the logical unit number (s) and 
virtual tile logical unit number (s) specified. If no logical unit 
number is specified , closes all open files. 

COMMON varl[ (intl[,int2] ) ] , var2 [ (intl [ ,int2] ) ] , . . . 

Preserves values and names of specified variables and arrays when 
the CHAI N s tatement is executed . Both string and arithmetic vari- 
aliies and arrays can be passea. The statement also dimensions 
the specified arrays. 

DATA number [ , " string" , number , . . . ] 

Used in conjunction w.ith READ to input listed data into an exe- 
cuting program. Can contain any mixture of strings and numbers. 

DEF FNletter (varl [ ,var2 , . . . ,var5] )=expression 

Defines a user function. Letter may be any single letter A 
through Z . 

Reserves space in memory for arrays according to the subscript (s) 
specified after the variable name. 

END Optional, placed at the physical end of the program to terminate 
" execution. 

FOR var = exprl TO expr2 [STEP exprS] 

Sets up a loop to be executed the specified number of times. 
GOSUB line number 

Unconditionally transfers control to specified line of subroutine. 
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GO TO line number 

Unconditionally transfers control to specified line number. 

!THEN statement ) 
THEN line number > 
GO TO line number j 

Conditionally executes the specified statement or transfers con- 
trol to specified line number. When the condition is not satis- 
fied, execution continues at the next sequential line. The ex- 
pressions and the relational operator must all be string or all 
be numeric. 

I THEN statement ) 
THEN line number > 
GO TO line number ) 

Tests for end-of-file condition of input sequential file associ- 
ated with logical unit expr. 



INPUT [#expri:l ] varl[,var2,...] 



Inputs data from the file associated with the logical unit speci- 
fied by expr or from the user's terminal. Variables may be arith- 
metic or string, #expr can be followed by a comma or a colon. 

KILL string expr 

Deletes file specified by string expr. 

[LET] variable = expression 

Assigns value of expression to the specified variable. Variable 
and expression must be of the same type - either numeric or string, 

[LET] VF integer(exprl) = expr2 

Assigns value of expr2 to the exprl element of the virtual file 
VF integer. The data type of the virtual file and of expr2 
must be the same - either numeric or string. 

LINPUT [#expr|;|] varl [ ,var2, . . , ] 

Equivalent to INPUT (for compatibility only) . 
NAME string exprl TO string expr2 

Renames file specified by string exprl to name specified by strina 
NEXT variable 

Placed at end of FOR loop to return control to FOR statement. 

ON expression GOSUB line numberl [, line number2 , line numbers,...] 

Conditionally transfers control to subroutine at one line number 
specified in list. Value of expression determines the line num- 
ber to which control is transferred. 
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ON expression GO TO line numberl [, line number2,line numberS , ] 

Conditionally transfers control to one line number in the list. 
Value of expression determines the line number to which control 
is transferred. 

OPEN stringp""^ oUTPUt]^^ FILE [#) exprl [DOUBLE BUF] [ ,FILESIZE expr21 [ ,RECORDSIZE expr31[,M0DE expr4; 

Opens a file specified by string for input or output as specified 
(assumes input if neither specified) and associates file with the 
logical unit exprl. String expr is a file descriptor as described 
in section 2.2. 



OPEN string 



FOR INPUT 
FOR OUTPUT 



AS FILE VF int 



[(exprl)][=expr2] [,FILESIZE expr3] 



Opens a virtual array file specified by string. FOR OUTPUT creates 
a new file; FOR INPUT (or neither) allows either output or input to 
an existing file. Elements may be assigned a value by the LET VF 
statement. When % (percent sign) is specified, the data type is 
integer; when $ (dollar sign) is specified the data type is string; 
and when neither is specified, the data type is floating point, 
exprl specifies the dimension and expr2 specifies the string 
length (used with $ only) . 

OVERLAY string expr [LINE line number] 

Overlays or merges the program currently in memory with the program 
in the file specified by string, and when overlay is completed, 
transfers control to either the next sequential BASIC line number 
or the line number specified. String expr is a file descriptor 
as described in section 2.2 



PRINT [#expr i'\ ] [exprl, expr2 ,expr3 ,.. .] 



Prints values of expressions un the tej-uiinal or, Wiien speci^-iev., 
to the file associated with logical unit expr. Expressions can 
be numeric and string. The TAB function can also be included. 
Elements can be separated by either commas or semicolons. #expr 
can be followed by a comma or a colon. 



PRINT [#expr {[i ] USING string, [exprl, expr2, exprS , , 



.] 



Prints values of expressions on the terminal or, when specified, 
to the file associated with logical unit expr in the format deter- 
mined by string. Both numeric and string expressions can be 
used. Elements must be separated by commas. 



RANDOMIZE 

Causes the random number generator (RND function) to produce 
different random numbers every time the program is run. 

READ varl[,var2, var3,...] 

Assigns values listed in DATA statements to specified variables. 
Variables may be string or numeric. 
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REM [comment] 

No effect on execution of program. Contains explanatory comments 
in a BASIC program. 

RESET [[#]expr] 

Equivalent to RESTORE. 

RESTORE [[#]exprl[,[#]expr2, [#] expr3 , . . . ] ] 

Resets either the data pointer or, when specified, the input 
file(s) associated with logical unit number (s) specified to the 
beginning. File(s) must be on file structured devices. 



RETURN 



Terminates a subroutine and returns control to the statement fol- 
lowing the last executed GOSUB statement. 



STOP 



Terminates execution of the program. Placed at logical end(s) of 
the program. 



B.3 SUMMARY OF BASIC FUNCTIONS 



ARITHMETIC FUNCTIONS 



The following functions perform standard mathematical operations in 
BA^IC - 



Name 



Explanation 



ABS(expr) 
ATN(expr) 

COS (expr) 
EXP(expr) 

INT (expr) 

LOG (expr) 

LOGIO (expr) 

PI 

RND[ (expr) ] 

SGN(expr) 



Returns the absolute value of expr. 

Returns the arctangent of expr as an angle in 
radians in the range + or - pi/2. 

Returns the cosine of expr radians. 

Returns the value of e+expr where e is (approxi- 
mately) 2.71828. 

Returns the greatest integer less than or equal 
to expr. 

Returns the natural logarithm of expr. 

Returns the base 10 logarithm of expr. 

Returns the value of pi = 3.141593 (approximately) 

Returns a random number between and 1. 

Returns a value indicating the sign of expr. 
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Name Explanation 

SIN{expr) Returns the sine of expr radians. 

SQR(expr) Returns the square root of expr. 

TAB (expr) Causes the terminal type head to tab to column 

number expr (valid only in PRINT statements) . 

SYS (exprl[ ,expr2] ) Special system function calls; control terminal 

j.nputi/ouupuu cinQ pci- juoriii o^d^-j-d-i- j_uiiwt,j.wiib. 

When exprl is; System Function 

Cancels effect of a CTRL/0 typed at terminal. 

1 Disables echoing and enters special mode for in- 
putting tapes on the low speed reader. 

2 Enables echoing; cancels effect of SYS(l) and 
SYS (3) . 

3 Disables echoing. 

4 Returns the ASCII value of the next character 
typed at the terminal; if specified, expr 2 is the 
logical unit number associated with the file from 
which the next character should be read. 

5 Deletes current program; changes program name to 
NONAME; and returns to the READY message. 

6 Set the terminal margin to the value of expr2 . 

7 Enables CTRL/C as interrupt. 

8 Privileged; disables CTRL/C as interrupt. 

-1 Privileged function; sets the user ID to that 

specified by the ASCII value in expr2; if 
expr2=ASC("X")+256*ASC("Y") then the ID will be 
"XY". Unprivileged if expr2 is negative, in 
which case it returns current user ID. 

— 2 '^lears ^rivile^ed user bit' user will not be 

able to execute any privileged functions or 
file operations. 

-3 Privileged function; returns to RT-11 Monitor. 

-4 Returns privilege status; zero for nonprivileged 

and one for privileged. 
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STRING FUNCTIONS 

The string functions are: 



ASC (string expr) 

BIN (string expr) 

CHR$(expr) 

DAT$ 

LEN (string expr) 



Returns as a decimal number the 8-bit internal 
code (ASCII value) for the 1-character string 
expr. 

Converts a string expression containing a bi- 
nary number to a decimal value. Blanks are 
ignored . 

Generates a 1-character string whose ASCII value 

is the low-order 8 bits of the integer value of expr. 

Returns the date as a string in the form 
dd-raon-yr (for example jaf7-FEB-75) . 

Returns the number of characters in the string 
expr. 



OCT (string expr) Converts a string expression containing an octal 
Caaiv OtT ToDtt number to a decimal value. Blanks are ignored. 



POS (string exprl, Searches for and returns the position of the 
string expr2, first occurrence of string expr2 in string 
expr) exprl. The search starts at the expr character 

position in string exprl. 

SEG$ (string expr, expr l,expr2) 

Returns the string of characters in positions 
exprl through expr2 in string expr. 



STR$ (expr) 

TRM$ (string expr) 
VAL (string expr) 



Returns the string which represents the numeric 
value of expr. 

Returns string expr without trailing blanks. 

Returns the value of the decimal number contained 
in the string expr . 



B , 4 SUMMARY OF BASIC COMMANDS 



Command 



Explanation 



APPEND [file descriptor] Merges the program in core with the program 

specified by the file descriptor. 



ASSIGN device: 



BYE 



CLEAR 



DEASSIGN [device:] 



Assigns specified device to the user if it is 
available. 

Terminates the session of the user issuing 
the command; deletes all open output files 
and deassigns all devices. 

Initializes all variables to zero, and all 
string variables to nulls and deletes arrays. 

Deassigns the specified device or all assigned 
devices. 
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Command 



Explanation 



HELLO 
KEY 

LENGTH 



Special command to get started with BASIC. 

Enables echoing after TAPE command or SYS(l) 
or SYS (3) function call. 

Displays on the terminal the size of the pro- 
gram in memory and the size of the remaining 
free memory. 



LIST[NH] [line number] 
■line number. 



[ 



■END 



NEW [program name] 



OLD [file descriptor] 



RENAME [program name] 



REPLACE [file descriptor] 



RUN[NH] 



RUN[NH] file descriptor 



SAVE [file descriptor] 



SCR[ATCH] 



SET TTY type 



TAPE 



Prints on the terminal the specified line(s) 
of the program currently in memory. NH sup- 
presses the printing of the header line. 

Erases the entire storage area of user and 
sets the current program name to the one 
specified. 

Erases the entire storage area of user and 
inputs the program from the specified file. 

Changes the current program name to the one 
specified. 

Replaces the specified file with the current 
program. 

Executes the program in memory. NH suppresses 
the printing of the header line. 

Erases the entire storage area of user, in- 
puts the program from the specified file, and 
then executes the program. Does not print 
header line in any case. 

Outputs the program in memory as the specified 
file (can be used to list a program on the 
line printer or punch it on the high-speed 
paper tape punch) . 

Erases the user's entire storage area, but 
preserves the program name . 

Sets system to allow different terminals; 
type may be VT05, ASR33, or LA30. 

Disables echoing for entering tapes from the 
low-speed reader. 



UNSAVE[file descriptor] Deletes specified file, 
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Key Commands 



Explanation 



CTRL/C 



CTRL/0 



CTRL/Q 



CTRL/S 



CTRL/U 



Interrupts execution of a command or program and 
causes BASIC to print the READY message. The 
execution of SYS (8) function call disables CTRL/C. 
Echoes as "+C". 

Causes all further terminal output to be discarded, 
If an INPUT statement is encountered, a SYS(0) 
function call is executed, or CTRL/0 is retyped, 
printing resumes. Occasionally CTRL/0 suppresses 
the printing of the READY message. Echoes as "+0", 

Continues output to the terminal; cancels effect 
of CTRL/S. May be XON on some terminals. Does 
not echo. 

Temporarily suspends all output to terminal until 
CTRL/Q is typed; allows alphanumeric display ter- 
minals (VT05) to be read or photographed before 
data is moved off screen. May be XOFF key on 
some terminals. Does not echo. 

Deletes the entire current input line (provided 
the RETURN key has not been typed) . BASIC dis- 
plays 



RUBOUT 



+U 
at the end of the line 
10 



For example ; 



BLET A fU 

t 

CTRL/U typed here. 

Deletes the last character typed and echoes as a 
backarrow {underscore on some terminals) on the 
terminal. For example. 



FOR N = 3-«-l TO 3 

t 

RUBOUT typed here. 

RUBOUT can be repeated to delete any character 
up to the beginning of the line. Spaces are 
considered valid characters and are deleted by 
RUBOUT s. 
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VIRTUAL ARRAY FACILITY 



The virtual array facility allows a BASIC program to operate on data 
structures that are too large to be accommodated in memory at one time. 
To accomplish this, BASIC uses the disk file system for storage of 
data arrays, and maintains only portions of these files in memory at 
any given time. 

An essential difference between real arrays and their virtual counter- 
parts is the time required to reference array elements. In real ar- 
rays, the referencing order has no effect on the time required to 
reference an element. In virtual arrays, this order can have a signi- 
ficant effect on the program execution time. This appendix describes 
the algorithms used in the virtual array processor, so that users may 
optimize their use of this facility. 

Each MU BASIC/RT-11 disk file is a contiguous sequence of 256-word 
records. Any position in a file can be specified internally with a 
2- component address; the first component is the relative block within 
the file, the second is the position of the item within the block. 
One of the functions of the virtual array processor is to transform 
each virtual array reference into its corresponding file address. 
This is called mapping. 

Virtual arrays are stored as unformatted binary data. This means that 
no I/O conversions need be performed in storing or retrieving elements 
in virtual storage. Thus, there is no loss of precision in these ar- 
rays, and no time wasted performing conversions. 

All references to virtual arrays are ultimately located via file ad- 
dresses relative to the start of the file. No symbolic information 
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concerning dimensions or data types is stored within the file. Thus, 
different programs may use different data types to refer to the data 
contained within a single virtual array file. The user must be 
cautious in such operations, since it is the user's responsibility to 
ensure that all programs referencing a given set of virtual arrays are 
referencing the correct data. Consider the following example: 

Program ONE contains 

10 OPEN "FILE" AS FILE VFl% 



Program TWO contains 

10 OPEN "FILE" AS FILE VF2 

Whenever program TWO references the array VF2, it is using the data 
known to program ONE as array VFl, VF2 contains floating-point data 
while VFl contains integer data. These two arrays do not correspond 
in data type and the data program ONE creates may be meaningless to 
program TWO and vice versa. 



NOTE 

A virtual file should not be simultaneously 
opened under two or more different channels 
(by one user or two) and have data changed 
on more than one channel. For example: 

50 OPEN "VALUES" AS FILE VFl (100) 

60 OPEN "VALUES" AS FILE VF2 (100) 

70 VFl(l) = 10 

80 VF2(2) = 20 

Only ore of these two assignment statements 
is effective. The other value is lost, 
because two buffers have been created and 
the last buffer to be written out destroys 
the changed data in the first buffer writ- 
ten out. 



C.l ARRAY STORAGE 

Strings in virtual storage occupy pre-allocated (determined by OPEN 
statement) space in the virtual file, and thus differ from strings in 
memory storage, where space is allocated dynamically, A virtual file 
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containing strings can be considered to be a succession of fields, 
each of the maximum string length. When a string in a virtual file is 
assigned a new value, it is stored left- justified in the appropriate 
field. If the new string is shorter than the maximum length, the re- 
mainder of the field is filled with null characters. When the string 
is retrieved, the trailing null characters are removed. 



Table C-1 describes the number of elements of each data type that can 
be stored in one 256-word (512-byte) block. 



Table C-1 
Virtual Array Storage Capabilities 





Number 


Number 


Data Type 


Bytes per Element 


Elements per Block 


Floating Point 


4 


128 


Integer {%) 


2 


256 


String {$) 


32 


16 


String ($=string length) string length 


512/string length 



The string length must be in the range 1-255. The number of string 
elements per block can be fractional. 

C.2 TRANSLATION OF ARRAY SUBSCRIPTS INTO FILE ADDRESSES 

In order to translate an array subscript into a file address, BASIC 
computes the relative distance from the specified item to the first 
item in the array. This is computed from the array subscript and the 
number of elements per block, as shown in Table C-1. The relative 
distance is added to the starting address of the file (determined by 
the OPEN statement processor) to find the address of the block con- 
taining the item. 

Since the OPEN statement contains the only information used to define 
the structure of a file, it is possible for the user to specify dif- 
ferent accessing arrangements for the same file in one or more pro- 
grams. For example, the user can reference the same data as a series 
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of either 32-byte strings or 16-byte strings, with the following state- 
ments: 

10 OPEN "ABC" AS FILE VF1$ (10^j2f) = 16 
30 OPEN "ABC" AS FILE VF2$ (500) = 32 

The user should keep in mind that in MU BASIC/RT-11, as in most BASICS, 
array subscripts begin with , not 1 . An array with dimension n actu- 
ally contains n+1 elements. 

C.3 ACCESS TO DATA IN VIRTUAL ARRAYS 

Only a portion of a virtual array is in memory at any given time. This 
data is transferred directly between the device and an I/O buffer, cre- 
ated when the OPEN statement is executed. This buffer must be 256 
words (one block) long, and may not be specified as several blocks with 
the RECORDSIZE or DOUBLE BUF option in the OPEN statement. For each 
virtual array file, BASIC notes 

the block of the file currently in the buffer 

whether the data in the buffer has been modified since 
it was read into memory 

After BASIC translates a virtual array address into a file address, it 
checks whether the block that contains the referenced item is currently 
in the buffer. If the necessary block is present the reference pro- 
ceeds; but if not, another portion of the file is read into the buffer. 
If the current data in the buffer has been altered, it is necessary to 
rewrite this data on the device prior to reading new data into the 
buffer. 

The virtual array accessing algorithm is flow charted in Figure C-1. 
Users should design the order in which virtual file elements are refer- 
enced in their programs to minimize the reading and writing of blocks. 

C.4 ALLOCATING DEVICE STORAGE TO VIRTUAL FILES 

The FILESIZE or dimensions indicated in an OPEN statement set maximum 
allowable values for subscripts and are used to compute the initial 
size of the virtual file to be allocated on the device. The contents 
are not initialized to zero. The data previously recorded in a block 
(when it was part of another file) is available to the new owner of 
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/^VIRTUAL ARRAY^ 
\_ REFERENCE J 



TRANSLATE SUB- 
SCRIPT INTO FILE 
ADDRESS 




RKWRITE BLOCK 
IN FILE 



CLEAR 'MODIFIED' 
INDICATOR 



READ NEW 
FILE BLOCK 




SET 'MODIFIED' 
INDICATOR 



yes 



C PROCEED WITH \ 
OPERATION ) 



Figure C-1 
Virtual Array Accessing Algorithm 
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the block. Users whose files contain confidential information should 
explicitly overwrite all data in such files, prior to file deletion, 
in order to protect data contained therein. 
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MU BASIC/RT-11 PROGRAM STRUCTURE 



MU BASIC/RT-11 stores each user's program in memory in the following 
format : 



Arrays 



Buffers 



Strings 



Symbol Table 



User Code 



high address 



low address 



The symbol table and user code area are created when the program is 
entered. When the RUN command is given, the user program is scanned 
and arrays are set up. The string area is created during program exe- 
cution. 

The SCRatch command clears all the user code, siTubol table, strings, 
and arrays from memory. The CLEAR command clears the arrays and 
strings but does not affect the user code or symbol table. 

A symbol table entry is created for each distinct line number (four 
bytes) or variable name (ten bytes) referenced in the program. 
These entries are not deleted, however, even when all references in 
the program to a particular line number or variable are removed. 
Thus, if the program in memory is heavily modified, it may be desir- 
able to save it with the SAVE command and then restore the program 
with the OLD command to obtain the largest possible user area. 
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User-entered blanks that are not in REM statements or string constants 
and blanks produced by BASIC when listing or saving a program do not 
contribute to the size of the program in memory. The total amount of 
memory storage required to store a BASIC program (user code and symbol 
table) depends on the parameters (2 bytes = 1 word) listed in Table 
D-1. 



Table D-1 
Parameters in Memory Storage of BASIC Programs 



Parameter 


Contribution (bytes) 


Definition 


L 


7*L 


Total number of lines in the BASIC 
program. 


T 


T 


Total number of tokens in the pro- 
gram (see below for a description 
of BASIC tokens) . 


V 


10*V 


Total number of distinct variable 
names used in the program (in this 
context, a scalar and an array vari- 
able with the same name are con- 
sidered to be the same variable 
name) . 


R 


2*R 


Total number of occurrences of vari- 
able names and references to line 
numbers in the program (not includ- 
ing the line number at the beginning 
of each line) , 


11 


2*11 


Total number of integer constants 
whose absolute value is in the 
range 0<^x<^255. 


12 


3*12 


Total number of integer constants 
whose absolute value is in the 
range 255<x<^32767 , 


F 


5*F 


Total number of noninteger numeric 
constants and integer constants not 
in above ranges . 


N 


10*N 


Total number of NEXT statements in 
the program. 


U 


2*U 


Total number of references to the 
name of a user-defined function; 
e.g., FNA (including the definition 
itself) . 


S 


2*S 


Total number of REM statements, im- 
plied CALL statements, and string 
constants . 
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Table D-1 (Cont.) 
Parameters in Memory Storage of BASIC Programs 



Parameter 



none 



Contribution (bytes) 



Definition 



Total number of characters in all 
REM and implied call statements and 
string constants (number of charac- 
ters following REM, number of char- 
acters in an assembly language rou- 

tween (but not including) the quotes 
in a string constant) . 

End of program token. 



When programs are entered, BASIC converts certain words and special 
symbols (both are called keywords) to 1-byte tokens to conserve memory. 
Some BASIC keywords are: PRINT, IF, and THEN, functional references 
such as PI, SIN(, and SEG$ ( (the left parenthesis following a func- 
tion name is considered to be part of the name) , and special charac- 
ters such as 



) 

I 
II 

\ 



The + or - preceding a numeric constant is considered to be a separatp 
entity from the number. 

Every character in a REM statement or string constant requires one 
byte. To reduce program size minimize the number of characters in 
each. 

Each use of the multiple statement line saves six bytes. The program: 



10 A = 3 
20 B = 4 



takes six bytes more memory than the equivalent program 



10 A = 3\B = 4 
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When the BASIC program is running, the following additional array and 
string storage is required. For each numeric array, the number of 
bytes allocated is 

4*{SSlMAX+2) 

for a singly-dimensioned array, 



or 



4*[ (SSlMAX+1) * (SS2MAX+1) +1] 

for a doubly-dimensioned array, where SSIMAX and SS2MAX are the maxi- 
mum values of the first and second array subscripts, respectively. For 
each string array, the number of bytes allocated is 

2*(SSlMAX+2) 

for a singly-dimensioned array or 

2*[(SS1MAX+1) * (SS2MAX+1)+1] 

for a doubly-dimensioned array, where SSIMAX and SS2MAX are the maxi- 
mum values of the first and second array subscripts, respectively. 

For each non-null string scalar or array element of length N currently 
defined in the BASIC program, N+4 bytes of string storage are required. 
Null strings are not stored. The symbol table or array entry has a 
special indicator to specify a null string. 

In addition to these parameters, when an OPEN statement is executed 
a buffer is allocated from the user area if there is currently room. 
If there is no room in the user area, the buffer is allocated from a 
system I/O area common to all users (if room is available there) . 
Table D-2 contains the standard buffer sizes. A nonstandard buffer 
size may be specified on nonf ile-structured devices by means of the 
RECORDSIZE option in the OPEN statement. Specifying DOUBLE BUF causes 
allocation of two equal size buffers. 
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Table D-2 
Standard File Buffer Sizes 



Device 


Buffer Size (words) 


Disk 


256 


DECtape 


256 


Magtape 


256 


Cassette 


64 


High-speed paper tape punch 


12 


High-speed paper tape reader 


12 


Line printer 


16 


Card reader 


8 
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Abbreviations of device names, 2-3 
Accessing devices, 3-1 
Access to system, 1-2 
Alphaniimeric display terminal 
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Arithmetic functions, B-6 
Arithmetic operators, 1-5 
Array storage, C-2, C-3 
Array subscripts translated into 

file addresses, C-3 
ASCII character set, A-1 
ASR margins, 3-15 
Assembly language routines, 1-8 
Assignable devices, 3-1 
ASSIGN command, 3-3 
ASSIGNED state of device, 3-3 
At sign (@) in file descriptor, 

2-4, 2-5 

Binary files, random-access, 2-19 

Braces, B-1 

Buffer size, 2-14, D-5 

BYE command, 1-3, 2-13 

Cassette 

nonfile-structured, 2-19 

write-protected, 2-18 
CHAIN statement, 2-12 
Channel number (logical unit number), 

2-11 
Characters in file names, 2-9 
CLEAR command, D-1 
CLOSE statement, 2-12 
Commands, 3-1 
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file, 2-6 

summary of, B-1, B-8 
Compatibility with single-user 

BASIC/RT-11, 2-8 
Conventions of documentation, B-1 
Conversion codes, ASCII/octal/ 

decimal, A-2, A-3, A-4 
CTRL/C key command, 2-12, 3-6, 3-16 
CTRL/0 icey command disabled, 3—11 
CTRL/g key command, 3-6 

.DAS (default extension) , 2-8 

Data access in virtual arrays, C-4 

Data files, 2-11 

Data storage, 2-1 

.DAT (default extension), 2-8 

DEASSIGN command, 3-3 

DECwriter margins, 3-15 

Default device, 2-3 

Device assignment, 3-1 

Device names and abbreviations, 2-3 

Devices accessed by file statements 

and commands, 2-6 
Devices supported by RT-11, 1-1 



Devices, system, 2-2 

Device storage allocation for 

virtual files, C-4 
Dial-up terminals, 3-8 
Documentation conventions, B-1 
Dollar sign ($) in file 

descriptor, 2-4, 2-5 
Double end-of-file, 2-16 

Echoing of low- speed reader/ 

punch, 3-11 
Ellipsis, B-2 

End-of-file condition, 2-12 
END statement, 2-12 
Enhancements to BASIC-11, 1-5 
Error, fatal program, 2-12 
Error messages, 4-1 
Example program demonstrating 

OPEN statement, 2-15 
Example program of octal dump, 2-24 
expression, B-2 
Extension, filename and, 2-4 
Extension specification, 2-5 

Fatal program error, 2-12 
File 

classes, 2-3 

commands, 2-6 

deletion, 2-16, 2-25 

descriptor, 2-2 

protection, 2-8 

renaming, 2-25 

searches, 2-18 

size, 2-14, 2-21 

statements, 2-6 
File addresses derived from array 

subscripts, C-3 
File buffer 

sizes, D-5 

storage, 3-5 
Filename and extension, 2-4 
Files, 2-1 

closing, 2-12 

deletion and renaming, 2-25 

purged, 2-13 

restrictions to simultaneous 
access, 2-26 
Files 

data, 2-11 

integer virtual, 2-20, 2-21 

multiple volume, 2-17 

program, 2-10 

random access binary, 2-19 

sequential data, 2-11 

sequential on magtape and 
cassette, 2-16 

virtual array, 2-19, 2-22 
File, sentinel, 2-16 
FILESIZE option, 2-14 
Fill characters, 3-8 
Floating point virtual array file, 
2-21 
INDEX-1 



Function calls, 3-9 

summary, 3-10 
Functions, 3-1 

arithmetic, B-6 

enhancements to, 1-7 

string, B-8 

summary of, B-1, B-6 



Group files, 2-1 
Group library files, 

HELLO feature, 1-1 



2-4, 2-8, 2-10 



IF END # statement, 2-12 

Input and output, 2-1 

INPUT # statement, 2-11 

integer, B-2 

Integer virtual files, 2-20, 2-21 

IN USE state of device, 3-3 

KEY command, 3-7 
KILL statement, 2-26 
KSR margins, 3-15 

LA3J2f and LA36 margins, 3-15, 3-16 

LENGTH command, 3-3 

LET statement with system function 

call, 3-9 
Library files, group and public, 

2-8, 2-10 
line number, B-2 
Logical end-of-tape, 2-16 
Logical unit number (channel number) , 

2-11 
Log-off procedure, 1-3 
Log-on procedure, 1-2 
Lower-case letters, B-1, B-2 
Low- speed paper tape reader/punch, 

3-7 
echo enable/disable, 3-11 

Magtape, sequential files on, 2-16 
Margin setting on terminals, 

3-14, 3-15, 3-16 
Memory requirements, 3-4 
Memory storage, 3-3, D-2 
Messages, error, 4-1 
MODE option, 2-17, 2-18 
Multiple volume files, 2-17 

Named files, 2-4 

Names of devices (and abbreviations) , 

2-3 
NEW command, 2-13 
Nonfile-structured OPEN statement, 

2-19 
Nonprivileged user, 2-8, 2-10 
Nonpublic devices, 3-1, 3-2, 3-3 
Number sign (#) in file descriptor, 

2-4, 2-5 



OLD command, 2-13 
OPEN statement, 2-11 

format, 2-13 
OPEN statement for virtual files, 2-20 
OPEN statement, nonfile-structured, 

2-19 
Operators, arithmetic, 1-5 
Output speed, 2-14 
Output to terminal, 3-6 

Paper tape reader/punch, low-speed, 
3-7 

echo enable/disable, 3-11 
Password, 1-1, 1-2, 1-8 
Possible states for nonpublic 

devices, 3-2 
PRINT # statement, 2-11 
Priority of arithmetic operations, 

1-5 
Private files, 2-4, 2-8 
Privileged status set by system 

function, 3-17 
Privileged users, 1-4, 2-8, 2-10 
Program 

error, 2-12 

files, 2-10 

size, 3-4 

structure, D-1 
Program example demonstrating 

octal dump, 2-24 

OPEN statement, 2-15 
Programs 

memory storage of, D-2 

renaming of, 2-25 
Public devices, 3-1 
Public files, 2-1 

Public library files, 2-4, 2-8, 2-10 
Punch, low-speed paper tape, 3-7 

echo enable/disable, 3-11 

Random access files, 2-1, 2-19 
Reader, low-speed paper tape, 3-7 

echo enable/disable, 3-11 
READY message, 1-3, 1-4 
READY, return by system function, 3-13 
Record-locking facility, 2-27 
RECORDSIZE option, 2-14 
relational operator, B-2 
REM statements, D-2 
Renaming files or programs, 2-25 
Restricted operations, 1-4 
Restrictions to simultaneous 

file access, 2-26 
Return to RT-11 monitor by system 

function, 3-17 
Rewind operation, 2-17 
RUBOUT key command, 3-7 
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SCR comniand, 2-13, D-1 
Searches of files, 2-18 
Sentinel file, 2-16 
Sequential files, 2-1, 2-11 

on magtape and cassette, 
SET TTY coiimiand, 3-8 
Simultaneous file access 

restrictions, 2-26 
Single-character input mode, 3-12 
Size of 

buffer, 2-14 

file, 2-14 

pemnanent virtual file, 2-21 

program, 3-4 
Speed of output, 2-14 
Square brackets, B-2 
Start procedures, 1-1 
Statements 

enhancements to, 1-7 

file, 2-6 

sxommary of, B-1, B-3 
Stopping terminal output, 3-6 
STOP statement, 2-12 
Storage requirements of 

BASIC program, 3-3 

virtual arrays, 2-22 
string expression, B-2 
String functions, B-8 
Strings in virtual files, 2-20 
String virtual array file, 2-21 
Subscripts in virtual arrays, 2-20 
Supported devices, 1-1 
Symbols, B-1 
Symbol table, D-1 
System access, 1-2 
System buffer, 2-15 
System devices, 2-2 
System_ device used as default, 2-3 
System function calls, 3-9 

summary, 3-10 



TAPE command, 3-7 
Tape operations, 2-16, 2-17 
Terminal characteristics, 3-5 
Terminal, fill characters, 3-8 
Terminal margin set by system 

function, 3-14 
Terminal types, 3-8 
Terminating output at terminal. 
Terminating the session, 1-3 
Type-ahead feature, 3-5, 3-6 
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Unprivileged users, 1-4 

UNSAVE command, 2-10 

Update existing sequential file, 2-11 

Upper-case letters, B-1 

User code area, D-1 

User ID, 1-1, 1-2, 1-8 

set by system function, 3-16 
Users, privileged or unprivileged, 
1-4 

variable, B-2 

Virtual array facility, C-1 

accessing algorithm, C-5 

array subscripts translated to file 
addresses, C-3 

data access, C-4 

device storage, C-4 
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storage requirements, 2-22 
VT05 and VT50 margins, 3-15, 3-16 



Words in use, number of, 
Write-protect, 2-18 
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